Partager via

Type de ressource samlOrWsFedExternalDomainFederation

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Ressource qui permet à un locataire Microsoft Entra de configurer la fédération avec une autre organisation dont le fournisseur d’identité (IdP) prend en charge le protocole SAML ou WS-Fed. Cela permet au locataire Microsoft Entra d’autoriser les utilisateurs invités à accéder à ses ressources. Pour plus d’informations sur la fédération de fournisseur d’identité SAML/WS-Fed, consultez Fédération avec les fournisseurs d’identité SAML/WS-Fed pour les utilisateurs invités.

Hérite de samlOrWsFedProvider.

Méthodes

Méthode Type de retour Description
List collection samlOrWsFedExternalDomainFederation Obtenez la liste des objets samlOrWsFedExternalDomainFederation et leurs propriétés.
Create samlOrWsFedExternalDomainFederation Créez un objet samlOrWsFedExternalDomainFederation .
Obtenir samlOrWsFedExternalDomainFederation Lisez les propriétés et les relations d’un objet samlOrWsFedExternalDomainFederation .
Mettre à jour samlOrWsFedExternalDomainFederation Mettez à jour les propriétés d’un objet samlOrWsFedExternalDomainFederation .
Supprimer Aucune Supprime un objet samlOrWsFedExternalDomainFederation .
Répertorier les domaines collection externalDomainName Obtenez les ressources externalDomainName à partir de la propriété de navigation des domaines.
Créer un nom de domaine externe externalDomainName Créez un objet externalDomainName.

Propriétés

Propriété Type Description
displayName Chaîne Nom complet du fournisseur d’identité SAML ou WS-Fed. Hérité de identityProviderBase.
id String Identificateur unique du fournisseur d’identité. Hérité de l’entité.
issuerUri Chaîne URI de l’émetteur du serveur de fédération. Hérité de samlOrWsFedProvider.
metadataExchangeUri Chaîne URI du point de terminaison d’échange de métadonnées utilisé pour l’authentification à partir d’applications clientes enrichies. Hérité de samlOrWsFedProvider.
passiveSignInUri Chaîne URI vers lequel les clients web sont dirigés lors de la connexion aux services Microsoft Entra. Hérité de samlOrWsFedProvider.
preferredAuthenticationProtocol Chaîne Protocole d’authentification préféré. Les valeurs prises en charge sont ou samlwsfed. Hérité de samlOrWsFedProvider.
signingCertificate Chaîne Certificat actuel utilisé pour signer les jetons passés à la plateforme d’identités Microsoft. Le certificat est au format d’une chaîne codée en Base64 de la partie publique du certificat de signature de jeton du fournisseur d’identité fédéré et doit être compatible avec la classe X509Certificate2.

Cette propriété est utilisée dans les scénarios suivants :
  • si une substitution est requise en dehors de la mise à jour de la substitution automatique
  • un nouveau service de fédération est en cours de configuration
  • si le nouveau certificat de signature de jeton n’est pas présent dans les propriétés de fédération après la mise à jour du certificat de service de fédération.


L’ID Microsoft Entra met à jour les certificats via un processus de substitution automatique dans lequel il tente de récupérer un nouveau certificat à partir des métadonnées du service de fédération, 30 jours avant l’expiration du certificat actuel. Si aucun nouveau certificat n’est disponible, l’ID Microsoft Entra surveille les métadonnées quotidiennement et met à jour les paramètres de fédération du domaine lorsqu’un nouveau certificat est disponible.

Hérité de samlOrWsFedProvider.

Relations

Relation Type Description
Domaines collection externalDomainName Collection de noms de domaine des organisations externes avec qui le locataire est fédéré. Prend en charge $filter (eq).

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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