HomeUse CasesConceptsConfig GuidesDeveloper GuidesAPI Reference
API Reference

Remplace les attributs de l'utilisateur authentifié dans Cloud Directory.

put
https://{tenanturl}/v2.0/Me

Habilitation requise : anyone (Tout utilisateur authentifié).

En cas de succès, la réponse renvoyée comprend les détails de l'appartenance à l'utilisateur et au groupe. La méthode HTTP PUT est utilisée pour remplacer les attributs de la ressource. Par exemple, les clients qui ont précédemment récupéré l'intégralité de la ressource et l'ont révisée, peuvent remplacer la ressource en utilisant un HTTP PUT.
Les groupes de l'utilisateur ne peuvent pas être modifiés et sont ignorés dans la charge utile. L'appartenance à un groupe est gérée à l'aide des API PUT /v2.0/Groups/{id } et PATCH /v2.0/Groups/{id }

Par défaut, un courrier électronique est envoyé à l'utilisateur avec les attributs modifiés. Le modèle de courrier électronique pour le marquage se trouve à "notifications/user_management/profile/ {locale}/user_profile_modified_email.xml ". Passez le paramètre de requête themeId pour marquer le modèle d'e-mail pour les notifications. Pour désactiver les notifications par courrier électronique, envoyez l'option de notification " urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification " : {"notifyType":"NONE"} dans la charge utile.

Cette API nécessite un jeton d'accès de l'utilisateur authentifié qui est généré à partir d'une application client lors de l'ouverture de session. Cette API ne prend pas en charge l'utilisation d'un jeton d'accès généré par le client de l'API.
Envoyez un jeton d'accès utilisateur valide dans l'en-tête d'autorisation, en utilisant le schéma d'authentification par porteur.

Si l'avertissement d'intelligence de mot de passe personnalisé est activé et qu'un mot de passe répertorié est fourni, la réponse 200 inclut l'en-tête "isv-dictionary-policy" avec la valeur : "WARNLOCAL".
Si l'avertissement X-Force relatif à l'intelligence du mot de passe est activé et qu'un mot de passe répertorié est fourni, la réponse 200 inclut l'en-tête "isv-dictionary-policy" avec la valeur "WARNGLOBAL".
Si la prévention personnalisée de l'intelligence du mot de passe est activée et qu'un mot de passe répertorié est fourni, la réponse 400 peut inclure l'en-tête "isv-dictionary-policy" avec la valeur "ENFORCELOCAL". L'état d'erreur correspondant est "PWD_IN_DICTIONARY".
Si la prévention X-Force de l'intelligence des mots de passe est activée et qu'un mot de passe figurant dans le dictionnaire est fourni, la réponse 400 peut inclure l'en-tête "isv-dictionary-policy" avec la valeur "ENFORCEGLOBAL". L'état d'erreur correspondant est "PWD_IN_GLOBAL_DICTIONARY".

Query Params
string

Une liste d'attributs séparés par des virgules dont les valeurs doivent être hachées.

string

L'identifiant du thème que vous souhaitez appliquer.

Body Params

L'objet utilisateur qui contient les attributs de l'utilisateur à modifier.

schemas
array of strings
required

Un tableau de chaînes contenant les URI indiquant les espaces de noms des schémas SCIM qui définissent les attributs dans la structure JSON actuelle.
Les schémas "" urn:ietf:params:scim:schemas:core:2.0:User ", " urn:ietf:params:scim:schemas:extension:ibm:2.0:User ", " urn:ietf:params:scim:schemas:extension:enterprise:2.0:User " et " urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification " sont valides. Le schéma de l'utilisateur principal est requis.

schemas*
string
required

L'identifiant unique de l'utilisateur qui est généralement utilisé par l'utilisateur pour s'authentifier directement auprès du fournisseur de services. Il est souvent présenté à l'utilisateur comme son identifiant unique dans le système (contrairement aux attributs id ou externalId, qui sont généralement des identifiants opaques et peu conviviaux). Chaque utilisateur doit inclure une valeur userName non vide. Cet identifiant doit être unique pour l'ensemble des utilisateurs du consommateur de services. Il doit s'agir d'un identifiant stable qui ne change pas lorsque le même utilisateur est renvoyé dans des demandes ultérieures. La longueur maximale est de 256 caractères.

string

L'identifiant unique de la ressource qui est défini par le client de provisionnement. Il identifie une ressource entre le client d'approvisionnement et le fournisseur de services. Le client peut utiliser un filtre pour localiser la ressource avec cet identifiant dans le domaine de provisionnement. La longueur maximale est de 240 caractères.

string

Le titre de l'utilisateur, par exemple "Vice-président" La longueur maximale est de 128 caractères.

string

Mot de passe en clair de l'utilisateur. Cet attribut est utilisé pour spécifier un mot de passe initial lors de la création d'un nouvel utilisateur ou pour réinitialiser le mot de passe d'un utilisateur existant. La longueur maximale est de 4096 caractères. Si le mot de passe contient des caractères ASCII étendus, vous devez ajouter charset=utf-8 dans l'en-tête Content-Type lors de l'appel à l'API REST. Ne peut commencer par le caractère > et se terminer par le caractère <.

name
object
string

Le nom de l'utilisateur qui est affiché aux utilisateurs. Chaque utilisateur renvoyé peut inclure une valeur displayName non vide. Il s'agit généralement du nom complet de l'utilisateur décrit, par exemple Babs Jensen ou Mme Barbara Jensen. Toutefois, si cette information n'est pas disponible, un nom d'utilisateur ou un identifiant peut être utilisé, par exemple, bjensen. La valeur est l'étiquette textuelle principale par laquelle cet utilisateur est normalement affiché par le fournisseur de services lorsqu'il présente des informations aux utilisateurs. La longueur maximale est de 128 caractères.

string

Le code de langue identifiant la langue préférée de cette identité, par exemple, en-us ou fr-ca. La longueur maximale est de 5 caractères.

boolean

Valeur booléenne qui indique le statut administratif de l'utilisateur. La signification définitive de cet attribut est déterminée par le fournisseur de services. Par exemple, la valeur "true" indique que l'utilisateur peut se connecter, tandis que la valeur "false" indique que le compte de l'utilisateur a été suspendu. Si elle n'est pas spécifiée, la valeur par défaut est true.

emails
array of objects

Une liste d'adresses électroniques qui peuvent être utilisées pour créer un utilisateur.

emails
addresses
array of objects

Une liste d'adresses qui peuvent être utilisées pour créer un utilisateur.

addresses
phoneNumbers
array of objects

Une liste de numéros de téléphone qui peuvent être utilisés pour créer un utilisateur.

phoneNumbers
urn:ietf:params:scim:schemas:extension:ibm:2.0:User
object
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User
object
urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification
object
Headers
string
enum
Defaults to false

Si la valeur "true" est attribuée à un changement de mot de passe, l'utilisateur n'est pas tenu de modifier son mot de passe après s'être connecté.
Cette valeur n'est honorée que si le mot de passe de l'utilisateur est fourni.

Allowed:
Responses

Updated 9 months ago

Language
URL
Response 
 Choose an example:
application/scim+json
Updated 9 months ago