Identificar a conta a ser representadaIdentify the account to impersonate

Saiba como o aplicativo de serviço usa EWS para identificar o usuário a ser personificado.Learn how your service application uses EWS to identify the user to impersonate.

O aplicativo de serviço identifica a conta de usuário para representar usando um dos três identificadores a seguir:Your service application identifies the user account to impersonate by using one of the following three identifiers:

  • O endereço SMTP principal.The primary SMTP address.

  • O nome principal do usuário (UPN).The user principal name (UPN).

  • O identificador de segurança (SID).The security identifier (SID).

O identificador que você usa depende, naturalmente, nas informações disponíveis no seu aplicativo.The identifier that you use depends, of course, on the information that your application has available.

Identificando a conta de usuário para representarIdentifying the user account to impersonate

Seu aplicativo pode usar as solicitações de API gerenciada do EWS ou do EWS SOAP para identificar a conta de usuário que está representando.Your application can use either the EWS Managed API or EWS SOAP requests to identify the user account that it is impersonating. A API gerenciada do EWS usa a propriedade ExchangeService. ImpersonatedUserId para identificar o usuário representado.The EWS Managed API uses the ExchangeService.ImpersonatedUserId property to identify the impersonated user. O EWS usa o elemento ExchangeImpersonation , conforme mostrado no fragmento XML a seguir.EWS uses the ExchangeImpersonation element, as shown in the following XML fragment.

<soap:Header>
    <t:ExchangeImpersonation>
        <t:ConnectingSID>
            Identifier
        </t:ConnectingSID>
    </t:ExchangeImpersonation>
</soap:Header>

Cada uma das seções a seguir mostra como usar um dos identificadores.Each of the following sections shows how to use one of the identifiers. Para obter um exemplo que mostra o identificador de representação em ação, consulte Adicionar compromissos usando a representação do Exchange.For an example that shows the impersonation identifier in action, see Add appointments by using Exchange impersonation.

Usar o endereço de email SMTP para identificar a conta de usuárioUse the SMTP email address to identify the user account

O endereço de email SMTP é o endereço de email principal associado a uma conta de usuário.The SMTP email address is the primary email address that is associated with a user account.

Em um aplicativo da API gerenciada por EWS, você especifica o endereço de email SMTP junto com o valor de enumeração ConnectingIdType. SMTP .In an EWS Managed API application, you specify the SMTP email address along with the ConnectingIdType.SMTP enumeration value.

exchangeServiceInstance.ImpersonatedUserId = new ImpersonatedUserId(ConnectingIdType.SMTP, "alisa@contoso.com");

Em uma solicitação SOAP do EWS, o elemento PrimarySmtpAddress contém o endereço de email da conta de usuário.In an EWS SOAP request, the PrimarySmtpAddress element contains the email address for the user account.

<soap:Header>
  <t:ExchangeImpersonation>
    <t:ConnectingSID>
      <t:PrimarySmtpAddress>alisa@contoso.com</t: PrimarySmtpAddress>
    </t:ConnectingSID>
  </t:ExchangeImpersonation>
</soap:Header>

Usar o UPN para identificar a conta de usuárioUse the UPN to identify the user account

O UPN contém o nome de domínio totalmente qualificado (FQDN) para o local da conta de usuário.The UPN contains the fully qualified domain name (FQDN) for the location of the user account. Isso não é necessariamente o domínio de caixa de correio do usuário.This is not necessarily the user's mailbox domain. O atributo userPrincipalName deve ser definido corretamente na conta de usuário no AD DS (serviços de domínio Active Directory) para que a pesquisa do usuário seja bem-sucedida.The UserPrincipalName attribute must be set correctly on the user account in Active Directory Domain Services (AD DS) for the user lookup to succeed.

Em um aplicativo da API gerenciada por EWS, você especifica o UPN junto com o valor de enumeração ConnectingIdType. PrincipalName .In an EWS Managed API application, you specify the UPN along with the ConnectingIdType.PrincipalName enumeration value.

exchangeServiceInstance.ImpersonatedUserId = new ImpersonatedUserId(ConnectingIdType.PrincipalName, "alias@billing.contoso.com");

Em uma solicitação SOAP do EWS, o elemento ElementName (ConnectingSIDType complexType) (EWS) contém o UPN da conta de usuário.In an EWS SOAP request, the PrincipalName element (ConnectingSIDType complexType) (EWS) element contains the UPN for the user account.

<soap:Header>
  <t:ExchangeImpersonation>
    <t:ConnectingSID>
      <t:PrincipalName>alisa@billing.contoso.com</t:PrincipalName>
    </t:ConnectingSID>
  </t:ExchangeImpersonation>
</soap:Header>

Usar o SID para identificar a conta de usuárioUse the SID to identify the user account

O SID é o identificador da conta a ser representada em Security Descriptor Definition Language (SDDL) Form.The SID is the identifier of the account to be impersonated in security descriptor definition language (SDDL) form.

Em um aplicativo da API gerenciada por EWS, você especifica o SID junto com o valor de enumeração ConnectingIdType. Sid .In an EWS Managed API application, you specify the SID along with the ConnectingIdType.SID enumeration value.

exchangeServiceInstance.ImpersonatedUserId = new ImpersonatedUserId(ConnectingIdType.SID, "S-1-5-21-1493619105-1843311271-3936346804-1118");

Em uma solicitação SOAP do EWS, o elemento Sid contém o SID da conta de usuário.In an EWS SOAP request, the SID element contains the SID for the user account.

<soap:Header>
  <t:ExchangeImpersonation>
    <t:ConnectingSID>
      <t:SID>S-1-5-21-1493619105-1843311271-3936346804-1118</t:SID>
    </t:ConnectingSID>
  </t:ExchangeImpersonation>
</soap:Header>

Confira tambémSee also