POST Identity/Validate
Validates and returns missing information about an identity.
Requirements
- Permissions: The caller is not required to have any special permissions. This API call can validate identities from other providers. For example, a caller with local identity rights can validate an AD user.
- Token scope: Configuration
Headers
-
Content type: Content-Type:application/json.
- Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.
Parameters
|
Name |
Description |
|---|---|
|
ID |
Identity Information that describes a user or group. To get this information, call POST Identity/Browse or the UI. |
Returns
If the ID of the person or group is not present in Trust Protection Platform, the response body is empty.
|
Name |
Description |
|---|---|
|
ID |
An Identity Entry object for the ID and any missing fields. |
Example: Determine whether an identity is valid
Request
POST https://tpp.venafi.example/vedsdk/Identity/Validate
Authorization:Bearer 4MyGeneratedBearerTknz==
{
"ID":{
"PrefixedUniversal":"local:{20711980-df6e-4813-a6fa-d5930fa37ac8}"
}
}
Response
HTTP/1.1 200 OK
{
"ID":{
"FullName":"\\VED\\Identity\\Admin",
"Name":"Admin",
"Prefix":"local",
"PrefixedName":"local:Admin",
"PrefixedUniversal":"local:{20711980-df6e-4813-a6fa-d5930fa37ac8}",
"Type":1,
"Universal":"{20711980-df6e-4813-a6fa-d5930fa37ac8}"
}
}