Compartilhar via

Identificar a conta para representar

  • Artigo

Saiba como seu aplicativo de serviço usa o EWS para identificar o usuário a ser representado.

Seu aplicativo de serviço identifica a conta de usuário a ser representada usando um dos três identificadores a seguir:

  • O endereço SMTP primário.

  • O nome da entidade de usuário (UPN).

  • O SID (identificador de segurança).

O identificador que você usa depende, é claro, das informações que seu aplicativo tem disponíveis.

Identificando a conta de usuário a ser representada

Seu aplicativo pode usar as solicitações EWS Managed API ou EWS SOAP para identificar a conta de usuário que ela está representando. A API Gerenciada do EWS usa a propriedade ExchangeService.ImpersonatedUserId para identificar o usuário representado. O EWS usa o elemento ExchangeImpersonation , conforme mostrado no fragmento XML a seguir.

<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. Para obter um exemplo que mostra o identificador de representação em ação, consulte Adicionar compromissos usando a representação do Exchange.

Use o endereço de email SMTP para identificar a conta de usuário

O endereço de email SMTP é o endereço de email principal associado a uma conta de usuário.

Em um aplicativo de API Gerenciada do EWS, você especifica o endereço de email SMTP junto com o valor de enumeração ConnectingIdType.SMTP .

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.

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

Use o UPN para identificar a conta de usuário

O UPN contém o FQDN (nome de domínio totalmente qualificado) para o local da conta de usuário. Esse não é necessariamente o domínio da caixa de correio do usuário. O atributo UserPrincipalName deve ser definido corretamente na conta de usuário no Active Directory Domain Services (AD DS) para que a pesquisa do usuário tenha êxito.

Em um aplicativo de API Gerenciada do EWS, você especifica o UPN junto com o valor de enumeração ConnectingIdType.PrincipalName .

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

Em uma solicitação SOAP do EWS, o elemento PrincipalName (ConnectingSIDType complexType) (EWS) contém o UPN para a conta de usuário.

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

Use o SID para identificar a conta de usuário

O SID é o identificador da conta a ser representada no formulário SDDL (linguagem de definição de descritor de segurança).

Em um aplicativo de API Gerenciada do EWS, você especifica o SID junto com o valor de enumeração ConnectingIdType.SID .

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 para a conta de usuário.

<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ém