internalDomainFederation tipo de recurso

Namespace: microsoft.graph

Representa configurações de domínios de locatário federados e verificados com o Microsoft Entra ID. Use este recurso para definir as configurações de federação ao configurar a federação com o Microsoft Entra ID. Para obter informações sobre federação, consulte O que é federação com o Microsoft Entra ID?.

Herda de samlOrWsFedProvider.

Métodos

Método	Tipo de retorno	Descrição
List	Coleção internalDomainFederation	Leia as propriedades do objeto internalDomainFederation para o domínio.
Create	internalDomainFederation	Crie um novo objeto internalDomainFederation .
Get	internalDomainFederation	Leia as propriedades e as relações de um objeto internalDomainFederation .
Atualizar	internalDomainFederation	Atualize as propriedades de um objeto internalDomainFederation .
Delete	Nenhum	Exclua um objeto internalDomainFederation .

Propriedades

Propriedade	Tipo	Descrição
activeSignInUri	Cadeia de caracteres	URL do ponto de extremidade usado por clientes ativos ao autenticar com domínios federados configurados para logon único no Microsoft Entra ID. Corresponde à propriedade ActiveLogOnUri do cmdlet Set-EntraDomainFederationSettings do PowerShell.
displayName	Cadeia de caracteres	O nome de exibição do IdP (provedor de identidade federada). Herdado de identityProviderBase.
federatedIdpMfaBehavior	federatedIdpMfaBehavior	Determina se o Microsoft Entra ID aceita a MFA executada pelo IdP federado quando um usuário federado acessa um aplicativo regido por uma política de acesso condicional que requer MFA. Os valores possíveis são: acceptIfMfaDoneByFederatedIdp, enforceMfaByFederatedIdp, rejectMfaByFederatedIdp, unknownFutureValue. Para obter mais informações, consulte valores federatedIdpMfaBehavior.
id	Cadeia de caracteres	O identificador do provedor de identidade federado. Herdado da entidade.
isSignedAuthenticationRequestRequired	Booliano	Se true, quando solicitações de autenticação SAML forem enviadas para o IdP SAML federado, o Microsoft Entra ID assinará essas solicitações usando a chave de assinatura OrgID. Se false (padrão), as solicitações de autenticação SAML enviadas ao IdP federado não serão assinadas.
issuerUri	Cadeia de caracteres	URI do emissor do servidor de federação. Herdado de samlOrWsFedProvider.
metadataExchangeUri	Cadeia de caracteres	URI do ponto de extremidade de troca de metadados usado para autenticação de aplicativos cliente avançados. Herdado de samlOrWsFedProvider.
nextSigningCertificate	Cadeia de caracteres	Certificado de assinatura de token de fallback que também pode ser usado para assinar tokens, por exemplo, quando o certificado de assinatura principal expirar. Formatado como cadeias de caracteres codificadas em Base64 da parte pública do certificado de assinatura de token do IdP federado. Precisa ser compatível com a classe X509Certificate2. Assim como o signingCertificate, a propriedade nextSigningCertificate será usada se uma substituição for necessária fora da atualização de substituição automática, se um novo serviço de federação estiver sendo configurado ou se o novo certificado de assinatura de token não estiver presente nas propriedades de federação após o certificado do serviço de federação ter sido atualizado.
passiveSignInUri	Cadeia de caracteres	URI para o qual os clientes baseados na Web são direcionados ao entrar nos serviços do Microsoft Entra. Herdado de samlOrWsFedProvider.
preferredAuthenticationProtocol	authenticationProtocol	Protocolo de autenticação preferencial. Esse parâmetro deve ser configurado explicitamente para que o fluxo de autenticação passiva de federação funcione. Os valores possíveis são: wsFed, saml, unknownFutureValue. Herdado de samlOrWsFedProvider.
promptLoginBehavior	promptLoginBehavior	Define o comportamento preferencial para o prompt de entrada. Os valores possíveis são: translateToFreshPasswordAuthentication, nativeSupport, disabled, unknownFutureValue.
signingCertificate	Cadeia de caracteres	Certificado atual usado para assinar tokens passados para a plataforma de identidade da Microsoft. O certificado é formatado como uma cadeia de caracteres codificada em 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 substituição for necessária fora da atualização de substituição 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. O Microsoft Entra ID atualiza certificados por meio de um processo de substituição automática no qual tenta recuperar um novo certificado dos metadados do serviço de federação, 30 dias antes da expiração do certificado atual. Se um novo certificado não estiver disponível, o Microsoft Entra ID monitorará os metadados diariamente e atualizará as configurações de federação do domínio quando um novo certificado estiver disponível. Herdado de samlOrWsFedProvider.
signingCertificateUpdateStatus	signingCertificateUpdateStatus	Fornece o status e o carimbo de data/hora da última atualização do certificado de assinatura.
signOutUri	Cadeia de caracteres	URI para o qual os clientes são redirecionados quando saem dos serviços do Microsoft Entra. Corresponde à propriedade LogOffUri do cmdlet Set-EntraDomainFederationSettings do PowerShell.

valores federatedIdpMfaBehavior

Member	Descrição
acceptIfMfaDoneByFederatedIdp	O Microsoft Entra ID aceita a MFA executada pelo provedor de identidade federada. Se o provedor de identidade federada não executar a MFA, o Microsoft Entra ID executará a MFA.
enforceMfaByFederatedIdp	O Microsoft Entra ID aceita MFA executado por provedor de identidade federada. Se o provedor de identidade federada não executou a MFA, ele redirecionará a solicitação para que o provedor de identidade federada execute a MFA.
rejectMfaByFederatedIdp	O Microsoft Entra ID sempre executa a MFA e rejeita a MFA executada pelo provedor de identidade federada.

Observação

federatedIdpMfaBehavior é uma versão evoluída da propriedade SupportsMfa da configuração de Federação de Domínio.

• Não há suporte para alternar entre federatedIdpMfaBehavior e SupportsMfa .
• Quando a propriedade federatedIdpMfaBehavior é definida, o Microsoft Entra ID ignora a configuração SupportsMfa.
• Se a propriedade federatedIdpMfaBehavior nunca for definida, o Microsoft Entra ID continuará a respeitar a configuração SupportsMfa.
• Se nem federatedIdpMfaBehavior nem SupportsMfa estiverem definidos, o Microsoft Entra ID usará como padrão o acceptIfMfaDoneByFederatedIdp comportamento.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.internalDomainFederation",
  "id": "String (identifier)",
  "displayName": "String",
  "issuerUri": "String",
  "metadataExchangeUri": "String",
  "signingCertificate": "String",
  "passiveSignInUri": "String",
  "preferredAuthenticationProtocol": "String",
  "activeSignInUri": "String",
  "signOutUri": "String",
  "promptLoginBehavior": "String",
  "isSignedAuthenticationRequestRequired": "Boolean",
  "nextSigningCertificate": "String",
  "signingCertificateUpdateStatus": {
    "certificateUpdateResult": "String",
    "@odata.type": "microsoft.graph.signingCertificateUpdateStatus"
  },
  "federatedIdpMfaBehavior": "String"
}