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

Input 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.

Response description

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}"
   }
}