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 a um inquilino do Microsoft Entra configurar a federação com outra organização cujo fornecedor de identidade (IdP) suporta o protocolo SAML ou WS-Fed. Isto permite ao inquilino do Microsoft Entra permitir que os utilizadores convidados acedam aos respetivos recursos. Para obter mais informações sobre a federação de IdP SAML/WS-Fed, veja Federação com fornecedores de identidade SAML/WS-Fed para utilizadores convidados.
Herda de samlOrWsFedProvider.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | coleção samlOrWsFedExternalDomainFederation | Obtenha uma lista dos objetos samlOrWsFedExternalDomainFederation e as respetivas propriedades. |
| Create | samlOrWsFedExternalDomainFederation | Crie um novo objeto samlOrWsFedExternalDomainFederation . |
| Get | samlOrWsFedExternalDomainFederation | Leia as propriedades e relações de um objeto samlOrWsFedExternalDomainFederation . |
| Atualizar | samlOrWsFedExternalDomainFederation | Atualize as propriedades de um objeto samlOrWsFedExternalDomainFederation . |
| Delete | Nenhum | Elimina um objeto samlOrWsFedExternalDomainFederation . |
| Listar domínios | coleção externalDomainName | Obtenha os recursos externalDomainName a partir da propriedade de navegação de domínios. |
| Criar nome de domínio externo | externalDomainName | Crie um novo objeto externalDomainName. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| displayName | Cadeia de caracteres | O nome a apresentar 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. |
| metadataExchangeUri | Cadeia de caracteres | URI do ponto final do exchange de metadados utilizado para autenticação a partir de aplicações cliente avançadas. Herdado de samlOrWsFedProvider. |
| passiveSignInUri | Cadeia de caracteres | O URI para o qual os clientes baseados na Web são direcionados ao iniciar sessão nos serviços do Microsoft Entra. Herdado de samlOrWsFedProvider. |
| preferredAuthenticationProtocol | Cadeia de caracteres | Protocolo de autenticação preferencial. Os valores suportados incluem saml ou wsfed. Herdado de samlOrWsFedProvider. |
| signingCertificate | Cadeia de caracteres | Certificado atual utilizado para assinar tokens transmitidos para a plataforma de identidades da Microsoft. O certificado é formatado como uma cadeia codificada base64 da parte pública do certificado de assinatura de tokens do IdP federado e tem de ser compatível com a classe X509Certificate2. Esta propriedade é utilizada nos seguintes cenários:
O Microsoft Entra ID atualiza os certificados através de um processo de inscrição automática no qual tenta obter um novo certificado a partir dos metadados do serviço de federação, 30 dias antes da expiração do certificado atual. Se não estiver disponível um novo certificado, o Microsoft Entra ID monitoriza os metadados diariamente e atualiza as definições de federação do domínio quando estiver disponível um novo certificado. 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 inquilino está a federar. Suporta $filter (eq). |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
"id": "String (identifier)",
"displayName": "String",
"issuerUri": "String",
"metadataExchangeUri": "String",
"signingCertificate": "String",
"passiveSignInUri": "String",
"preferredAuthenticationProtocol": "String"
}