Type de ressource objectIdentity
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 .
Représente une identité utilisée pour se connecter à un compte d’utilisateur. Une identité peut être fournie par Microsoft, par des organisations ou par des fournisseurs d’identité sociale tels que Facebook, Google ou Microsoft. Cela permet à l’utilisateur de se connecter au compte d’utilisateur avec l’une de ces identités associées.
La propriété identities de la ressource utilisateur est un objet objectIdentity .
Propriétés
| Propriété | Type | Description |
|---|---|---|
| signInType | Chaîne | Spécifie les types de connexion utilisateur dans votre répertoire, tels que emailAddress, userName, federatedou userPrincipalName.
federated représente un identificateur unique pour un utilisateur d’un émetteur qui peut être dans n’importe quel format choisi par l’émetteur. La définition ou la mise à jour d’une userPrincipalName identité met à jour la valeur de la propriété userPrincipalName sur l’objet utilisateur. Les validations effectuées sur la userPrincipalName propriété sur l’objet utilisateur, par exemple les domaines vérifiés et les caractères acceptables, sont effectuées lors de la définition ou de la mise à jour d’une userPrincipalName identité. Une validation supplémentaire est appliquée sur issuerAssignedId lorsque le type de connexion est défini sur emailAddress ou userName. Cette propriété peut également être définie sur n’importe quelle chaîne personnalisée. Pour plus d’informations sur le comportement de filtrage de cette propriété, consultez Filtrage sur la propriété d’identités d’un utilisateur. |
| Émetteur | Chaîne | Spécifie l’émetteur de l’identité, par exemple facebook.com. Limite de 512 caractères. Pour les comptes locaux (où signInType n’est pas federated), cette propriété est le nom de domaine local par défaut pour le locataire, par exemple contoso.com. Pour les invités d’autres organisations Microsoft Entra, il s’agit du domaine du organization fédéré, par exemple contoso.com. Pour plus d’informations sur le comportement de filtrage de cette propriété, consultez Filtrage sur la propriété d’identités d’un utilisateur. |
| issuerAssignedId | Chaîne | Spécifie l’identificateur unique attribué à l’utilisateur par l’émetteur. Limite de 64 caractères. La combinaison de issuer et issuerAssignedId doit être unique dans le organization. Représente le nom de connexion de l’utilisateur, lorsque signInType est défini sur emailAddress ou userName (également appelé comptes locaux).Lorsque signInType est défini sur :
Pour plus d’informations sur le comportement de filtrage de cette propriété, consultez Filtrage sur la propriété d’identités d’un utilisateur. |
Filtrage
Lors du filtrage sur la propriété d’identités d’un issuerAssignedId :
- Le filtrage sur l’émetteur seul est pris en charge pour les valeurs suivantes :
google.com,facebook.com,mailetphone. - Le filtrage des entrées avec un signInType de
federatednécessite un émetteur valide et issuerAssignedId. - Le filtrage des entrées avec un signInType de
userNameouemailAddressnécessite un émetteur et un issuerAssignedId valides, mais ignore la valeur de l’émetteur. Ce comportement est voulu par la conception même du produit. - Le filtrage des entrées avec un signInType de
userPrincipalNamen’est pas pris en charge. Vous pouvez filtrer sur la propriété userPrincipalName de l’objet utilisateur à la place.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"signInType": "string",
"issuer": "string",
"issuerAssignedId": "string"
}