<issuedTokenAuthentication> de <serviceCredentials>

Artigo
06/08/2023

Especifica um token personalizado emitido como uma credencial de serviço.

<configuration>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>
          <serviceCredentials>
            <issuedTokenAuthentication>

Syntax

<issuedTokenAuthentication allowUntrustedRsaIssuers="Boolean"
                           audienceUriMode="Always/BearerKeyOnly/Never"
                           customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"
                           certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"
                           revocationMode="NoCheck/Online/Offline"
                           samlSerializer="String"
                           trustedStoreLocation="CurrentUser/LocalMachine">
  <allowedAudienceUris>
    <add allowedAudienceUri="String" />
  </allowedAudienceUris>
  <knownCertificates>
    <add findValue="String"
         storeLocation="CurrentUser/LocalMachine"
         storeName=" CurrentUser/LocalMachine"
         x509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />
  </knownCertificates>
</issuedTokenAuthentication>

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filho e os elementos pai

Atributos

Atributo	Descrição
`allowedAudienceUris`	Obtém o conjunto de URIs de destino para os quais o token de segurança SamlSecurityToken pode ser direcionado para ser considerado válido por esta instância de SamlSecurityTokenAuthenticator. Para obter mais informações sobre como usar esse atributo, consulte AllowedAudienceUris.
`allowUntrustedRsaIssuers`	Um valor booliano que especifica se emissores de certificado RSA não confiáveis são permitidos. Os certificados são assinados por autoridades de certificação (ACs) para verificar a autenticidade. Um emissor não confiável é uma AC que não é especificada para ser confiável para assinar certificados.
`audienceUriMode`	Obtém um valor que especifica se a SamlSecurityToken do token de segurança SamlAudienceRestrictionCondition deve ser validada. Esse valor é do tipo AudienceUriMode. Para obter mais informações sobre como usar esse atributo, consulte AudienceUriMode.
`certificateValidationMode`	Define o modo de validação de certificado. Um dos valores válidos de X509CertificateValidationMode. Se definido como `Custom`, também será necessário fornecer um `customCertificateValidator`. O padrão é `ChainTrust`.
`customCertificateValidatorType`	Cadeia de caracteres opcional. Um tipo e um assembly usados para validar um tipo personalizado. Esse atributo deverá ser definido quando `certificateValidationMode` estiver definido como `Custom`.
`revocationMode`	Define o modo de revogação que especifica se uma verificação de revogação ocorre e se ela é executada online ou offline. Esse atributo é do tipo X509RevocationMode.
`samlSerializer`	Um atributo de cadeia de caracteres opcional que especifica o tipo de SamlSerializer usado para a credencial de serviço. O padrão é uma cadeia de caracteres vazia.
`trustedStoreLocation`	Enumeração opcional. Um dos dois locais do repositório do sistema: `LocalMachine` ou `CurrentUser`.

Elementos filho

Elemento	Descrição
`knownCertificates`	Especifica uma coleção de X509CertificateTrustedIssuerElement elementos que especifica emissores confiáveis para a credencial de serviço.

Elementos pai

Elemento	Descrição
<serviceCredentials>	Especifica a credencial a ser usada na autenticação do serviço e as configurações relacionadas à validação de credencial do cliente.

Comentários

O cenário de token emitido tem três fases. Na primeira fase, um cliente que tenta acessar um serviço é encaminhado para um serviço de token seguro. Em seguida, o serviço de token seguro autentica o cliente e, posteriormente, emite um token ao cliente, normalmente um token SAML (Security Assertions Markup Language). Então, o cliente retorna ao serviço com o token. O serviço examina o token para obter dados que lhe permitem autenticar o token e, portanto, o cliente. Para autenticar o token, o certificado que o serviço de token seguro usa deve ser conhecido pelo serviço.

Esse elemento é o repositório para qualquer certificado de serviço de token seguro. Para adicionar certificados, use os <knownCertificates>. Insira um <suplemento> para cada certificado, conforme mostrado no exemplo a seguir.

<issuedTokenAuthentication>
  <knownCertificates>
    <add findValue="www.contoso.com"
         storeLocation="LocalMachine"
         storeName="My"
         X509FindType="FindBySubjectName" />
  </knownCertificates>
</issuedTokenAuthentication>

Por padrão, os certificados devem ser obtidos de um serviço de token seguro. Esses certificados "conhecidos" garantem que somente clientes legítimos possam acessar um serviço.

Para obter mais informações sobre como usar esse elemento de configuração, consulte Como configurar credenciais em um serviço de federação.

Compartilhar via