tipo de recurso samlOrWsFedExternalDomainFederation

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Um recurso que permite que um locatário Microsoft Entra configure a federação com outra organização cujo IdP (provedor de identidade) dá suporte ao protocolo SAML ou WS-Fed. Isso permite que o locatário Microsoft Entra permita que os usuários convidados acessem seus recursos. Para obter mais informações sobre a federação de IdP do SAML/WS-Fed, consulte Federação com provedores de identidade SAML/WS-Fed para usuários convidados.

Herda de samlOrWsFedProvider.

Métodos

Método	Tipo de retorno	Descrição
Listar samlOrWsFedExternalDomainFederations	coleção samlOrWsFedExternalDomainFederation	Obtenha uma lista dos objetos samlOrWsFedExternalDomainFederation e suas propriedades.
Criar samlOrWsFedExternalDomainFederation	samlOrWsFedExternalDomainFederation	Crie um novo objeto samlOrWsFedExternalDomainFederation .
Obter samlOrWsFedExternalDomainFederation	samlOrWsFedExternalDomainFederation	Leia as propriedades e as relações de um objeto samlOrWsFedExternalDomainFederation .
Atualizar samlOrWsFedExternalDomainFederation	samlOrWsFedExternalDomainFederation	Atualize as propriedades de um objeto samlOrWsFedExternalDomainFederation .
Excluir samlOrWsFedExternalDomainFederation	Nenhum	Exclui um objeto samlOrWsFedExternalDomainFederation .
Listar domínios	coleção externalDomainName	Obtenha os recursos externalDomainName da propriedade de navegação de domínios.
Criar externalDomainName	externalDomainName	Crie um novo objeto externalDomainName.

Propriedades

Propriedade	Tipo	Descrição
displayName	Cadeia de caracteres	O nome de exibição do IdP baseado em SAML ou WS-Fed. Herdado de identityProviderBase.
id	Cadeia de caracteres	O identificador do provedor de identidade. Herdado da entidade.
issuerUri	Cadeia de caracteres	URI do emissor do servidor de federação. Herdado de samlOrWsFedProvider.
metadadosExchangeUri	Cadeia de caracteres	URI do ponto de extremidade de troca de metadados usado para autenticação de aplicativos cliente avançados. Herdado de samlOrWsFedProvider.
passiveSignInUri	Cadeia de caracteres	URI ao qual os clientes baseados na Web são direcionados ao entrar nos serviços de Microsoft Entra. Herdado de samlOrWsFedProvider.
preferredAuthenticationProtocol	Cadeia de caracteres	Protocolo de autenticação preferencial. Os valores com suporte incluem saml ou wsfed. Herdado de samlOrWsFedProvider.
signingCertificate	Cadeia de caracteres	Certificado atual usado para assinar tokens passados para o plataforma de identidade da Microsoft. O certificado é formatado como uma cadeia de caracteres codificada base64 da parte pública do certificado de assinatura de token do IdP federado e deve ser compatível com a classe X509Certificate2. Essa propriedade é usada nos seguintes cenários: se uma rolagem for necessária fora da atualização de rolagem automática um novo serviço de federação está sendo configurado se o novo certificado de assinatura de token não estiver presente nas propriedades de federação após a atualização do certificado de serviço de federação. Microsoft Entra ID atualiza certificados por meio de um processo de autorollover no qual tenta recuperar um novo certificado dos metadados do serviço de federação, 30 dias antes do término do certificado atual. Se um novo certificado não estiver disponível, Microsoft Entra ID monitorará os metadados diariamente e atualizará as configurações de federação para o domínio quando um novo certificado estiver disponível. Herdado de samlOrWsFedProvider.

Relações

Relação	Tipo	Descrição
Domínios	coleção externalDomainName	Coleção de nomes de domínio das organizações externas com as quais o locatário está federando. Suporta $filter (eq).

Representação JSON

Veja a seguir uma representação JSON do recurso.

{
  "@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
  "id": "String (identifier)",
  "displayName": "String",
  "issuerUri": "String",
  "metadataExchangeUri": "String",
  "signingCertificate": "String",
  "passiveSignInUri": "String",
  "preferredAuthenticationProtocol": "String"
}