Credentials can be accessed and modified through this API using four services: GET, POST, PUT, and PATCH. These four services allow for the retrieval, creation, complete update, and partial update of Credentialscredentials.

Authentication - Use Basic Authentication for this API.

Request

Parameter	Required	Type	Description
Id	Yes	URL	URL parameter for the Id which is used to find and return a Credential

Response Codes

HTTP Code	Description
200	Credential was found and returned
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
404	Credential not found
500	Unexpected internal server error

Example

If we a Credential in our database with an Id of 11004 and the following attributes

Code Block

theme	Eclipse
title	Credential - 11004

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "GET Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000,
    "credentialInputs": [
        {
            "versionNumber":1,
            "inputValue": "TestPassword",
            "credentialStoreInputDefId": 12000
        }
    ]
}

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/11004

The GET request would return the following JSON Credential object

Code Block

theme	Eclipse
title	Credential GET Return JSON

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "GET Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000,
    "credentialInputs": [
        {
            "versionNumber":1,
            "inputValue": "TestPassword",
            "credentialStoreInputDefId": 12000
        }
    ]
}

GET by Query Parameters

This GET service will return a list of Credentials in the form of JSON objects based on the query parameters credentialId, credentialName, credentialScope, and credentialStoreId. Credentials are only returned if they match ALL of the specified query parameters. If no query parameters are given, this request will return the entire list of Credentials. The credentialName parameter returns Credentials that contain the specified parameter. The other parameters must be equal to the Credentials.

Info

title	API URL

http://host:port/flexdeploy/rest/v2/administration/security/credential?

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

credentialId={credentialId}

credentialName={credentialName}

credentialScope={credentialScope}

credentialStoreId={credentialStoreId}

Examples:

To Specify the

code

NAME parameter only:

http://host:port/flexdeploy/rest/v2/administration/security/credential?credentialName={credentialName}

To Specify the

code and group code

NAME AND SCOPE parameters:

http://host:port/flexdeploy/rest/v2/administration/security/credential?credentialName={credentialName}&credentialScope={credentialScope}

To Specify the name,

group code, and sub group code

SCOPE, AND CREDENTIAL STORE ID parameters:

http://host:port/flexdeploy/rest/v2/administration/security/credential?credentialName={credentialName}&credentialScope={credentialScope}&credentialStoreId={credentialStoreId}

...

Output when querying by Credential Scope "ENVINST" through http://host:port/flexdeploy/rest/v2/administration/security/credential?credentialScope=ENVINST

Code Block

title	Sample JSON Output
collapse	true

[	
	{
		"credentialId": 11004,
    	"versionNumber": 1,
    	"credentialName": "GET Example Name 1",
    	"isActive": true,
    	"credentialScope": "ENVINST",
    	"credentialStoreId": 11000,
    	"credentialInputs": [
        	{
            	"versionNumber":1,
            	"inputValue": "TestPassword",
            	"credentialStoreInputDefId": 12000
        	}
    	]
	},
	{
		"credentialId": 11004,
    	"versionNumber": 1,
    	"credentialName": "GET Example Name 2",
    	"isActive": false,
    	"credentialScope": "ENVINST",
    	"credentialStoreId": 11020,
    	"credentialInputs": [
        	{
            	"versionNumber":1,
            	"inputValue": "TestPassword123",
            	"credentialStoreInputDefId": 13000
        	}
    	]
	},
]

...

Attributes	Type	Required	Description
credentialName	String	NoYes	Name of Credential.
isActive	Boolean	No	Whether or not this Credential is active. Defaults to true.
credentialScope	String	NoYes	Scope of the Credential. Possible values are ENDPOINT, INST, or ENVINST.
credentialStoreId	Long	NoYes	The unique id of the associated Credential Store.
credentialInputs	List<CredentialInputDataObject>	Yes	List of the Credential Input Data Objects that are associated with this Credential.

Response Codes

...

HTTP Code

...

Description

...

CredentialInputDataObject can include the following attributes:

Attributes	Type	Required	Description
inputValue	Depends on input	Yes	Value for credential input
credentialStoreInputDefId	Long	Yes	Id of input definition. Can be found using the Credential Store Provider API.

Response Codes

HTTP Code	Description
201	Credential was created successfully
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
500	Unexpected internal server error

...

Code Block

title	Sample JSON Input
collapse	true

{
    "credentialName": "POST Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000,
    "credentialInputs": [
        {
   
        "versionNumber":1,
            "inputValue": "TestPassword",
            "credentialStoreInputDefId": 12000
        }
    ]
}

...

Code Block

title	Sample JSON Output
collapse	true

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "POST Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000,
    "credentialInputs": [
        {
            "versionNumber":1,
            "inputValue			"credentialId": 11004,
			"updatedBy": "TestPasswordfdadmin",
            "credentialStoreInputDefId": 12000
        }			"updatedOn": "2021-09-10T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-10T12:59:34.821+0000",
			"isEncrypted": true,
           ]
}

PUT

This PUT service will update all attributes of a Credential with the given Id based on the attributes of the supplied JSON object.

Info

title	API URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/{Id}

Request

...

Attributes

...

Type

...

Description

...

 "versionNumber":1,
            "inputValue": "*****",
            "credentialStoreInputDefId": 12000,
			"credentialInputId": 284872
        }
    ]
}

PUT

This PUT service will update all attributes of a Credential with the given Id based on the attributes of the supplied JSON object.

Info

title	API URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/{credentialId}

Request

No

Attributes	Type	Required	Description
credentialId	URL	Yes	URL parameter for the Id which is used to find and update a Credential.
credentialName	String	Yes	Name of Credential.
isActive	Boolean	No	Whether or not this Credential is active. Defaults to true if nothing is passed.
credentialScope	String	NoYes	Scope of the Credential.	credentialStoreId	Long	Possible values are ENDPOINT, INST, or ENVINST. Scope cannot be updated with a PATCH request as it is locked in after creation.
credentialStoreId	Long	Yes	The unique id of the associated Credential Store. Credential store id cannot be updated with a PATCH request as it is locked in after creation.
credentialInputs	List<CredentialInputDataObject>	NoYes	List of the Credential Input Data Objects that are associated with this Credential. If currently associated Credential Input Data Object(s) are not in input list, those Data Objects will be unassigned from this Credential. i.e. at the end of successful request, the Credential will have mapped Property Sets matching to input request.

Response Codes

HTTP Code

CredentialInputDataObject can include the following attributes:

Attributes	Type	Required	Description

200Credential

inputValue	Depends on input	Yes	Value for credential input
credentialStoreInputDefId	Long	Yes	Id of input definition. Can be found using the Credential Store Provider API.

Response Codes

HTTP Code	Description
200	Credential was found and updated
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
404	Credential not found
500	Unexpected internal server error

Example

If we had an Credential in our database with an Id of 11104 and had the following attributes

Code Block

title	Current Credential
collapse	true

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "PUT Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000,
    "credentialInputs": [
         {
			"credentialId":            "versionNumber":1,
            "inputValue": "TestPassword",
            "credentialStoreInputDefId": 12000
        }11004,
			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-09T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-09T12:59:34.821+0000",
			"isEncrypted": true,
           ]
}

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/11104

And the PUT request receives the following JSON Credential object,

Code Block

title	Sample JSON Input
collapse	true

{ "versionNumber":1,
            "inputValue": "*****",
    "credentialName": "PUT Example Name",     "isActivecredentialStoreInputDefId": true12000,
			"credentialInputId": 284872
   "credentialScope": "INST",    }
"credentialStoreId": 12000,     "credentialInputs": [
        {
            "versionNumber":1,
 ]
}

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/11104

And the PUT request receives the following JSON Credential object,

Code Block

title	Sample JSON Input
collapse	true

{
    "credentialName": "PUT Example Name",
    "inputValueisActive": "TestPassword1234"true,
       "credentialScope": "INST",
    "credentialStoreInputDefIdcredentialStoreId": 12000,
    "credentialInputs": [
       }, 		{
            "versionNumber":1,inputValue": "TestPassword1234",
            "credentialStoreInputDefId": 12000
        },
		{
            "inputValue": "TestPass1999",
            "credentialStoreInputDefId": 12010
        }
    ]
}

The PUT request would then update the Credential with Id 11104 and return the following JSON Credential object.

Code Block

title	Sample JSON Output
collapse	true

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "PUT Example Name",
    "isActive": true,
    "credentialScope": "INST",
    "credentialStoreId": 12000,
    "credentialInputs": [
         {
			"credentialId":            "versionNumber":1,
            "inputValue": "TestPassword1234",
            "credentialStoreInputDefId": 12000
        },
		{11004,
			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-10T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-10T12:59:34.821+0000",
			"isEncrypted": true,
            "versionNumber":1,
            "inputValue": "TestPass1999*****",
            "credentialStoreInputDefId": 12010
 12000,
			"credentialInputId": 24895
      }  },
		  ]
}

PATCH

This PATCH service will update the information of the Credential of the specified Id with the non-null parameters of the JSON. The parameters that are null or missing will not be changed in the Credential.

Info

title	API URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/{Id}

Tip
The only required attribute is the Credential Id in the URL.

Request

...

Attributes

...

Type

...

Description

...

Whether or not this Credential is active.

Defaults to true if nothing is passed.

...

Scope of the Credential.

...

If input Credential Input Data Object(s) is not already associated, it will be associated to Credential but existing Data Object assignment that are not in PATCH request will not be unassigned.

i.e. input list is considered as append to existing assignments.

Response Codes

...

HTTP Code

...

Description

...

Example

...

{
			"credentialId": 11004,
			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-10T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-10T12:59:34.821+0000",
			"isEncrypted": true,
            "versionNumber":1,
            "inputValue": "*****",
            "credentialStoreInputDefId": 12010,
			"credentialInputId": 284872
        }
    ]
}

PATCH

This PATCH service will update the information of the Credential of the specified Id with the non-null parameters of the JSON. The parameters that are null or missing will not be changed in the Credential.

Info

title	API URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/{credentialId}

Tip
The only required attribute is the Credential Id in the URL.

Request

Attributes	Type	Required	Description
credentialId	URL	Yes	URL parameter for the Id which is used to find and update a Credential.
credentialName	String	No	Name of Credential.
isActive	Boolean	No	Whether or not this Credential is active.
credentialScope	String	No	Scope of the Credential. Possible values are ENDPOINT, INST, or ENVINST. Scope cannot be updated with a PATCH request as it is locked in after creation.
credentialStoreId	Long	No	The unique id of the associated Credential Store. Credential store id cannot be updated with a PATCH request as it is locked in after creation.
credentialInputs	List<CredentialInputDataObject>	No	List of the Credential Input Data Objects that are associated with this Credential. If input Credential Input Data Object(s) is not already associated, it will be associated to Credential but existing Data Object assignment that are not in PATCH request will not be unassigned. i.e. input list is considered as append to existing assignments.

CredentialInputDataObject can include the following attributes:

Attributes	Type	Required	Description
inputValue	Depends on input	Yes	Value for credential input
credentialStoreInputDefId	Long	Yes	Id of input definition. Can be found using the Credential Store Provider API.

Response Codes

HTTP Code	Description
200	Credential was found and patched
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
404	Credential not found
500	Unexpected internal server error

Example

If we had a Credential in our database with an Id of 11104 and had the following attributes

Code Block

title	Current Credential
collapse	true

{
	"credentialId": 11004,
    "versionNumber": 1,
    "credentialName": "PUT Example Name",
    "isActive": true,
    "credentialScope": "INST",
    "credentialStoreId": 11000,
    "credentialInputs": [
         {
			"credentialId": 11004,
			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-09T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-09T12:59:34.821+0000",
			"isEncrypted": true,
            "versionNumber":1,
            "inputValue": "*****",
            "credentialStoreInputDefId": 12000,
			"credentialInputId": 284895
        }
    ]
}

When we run a PATCH request at the following URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/11104

And the PATCH request receives the following JSON Credential object,

Code Block

title	Current Credential
collapse	true

{
	"credentialId":
11004,     "versionNumber": 1,
    "credentialName": "PUT Example Name",
    "isActive": true,
    "credentialScope": "ENVINST",
    "credentialStoreId": 11000INST",
    "credentialInputs": [
        {
            "versionNumber":1,
            "inputValue": "TestPasswordTestPass1999",
            "credentialStoreInputDefId": 1200012010
        }
    ]
}

When we run a The PATCH request at would then update the Credential with Id 11104 and return the following URL

http://host:port/flexdeploy/rest/v2/administration/security/credential/11104

And the PATCH request receives the following JSON Credential object,JSON Credential object.

Info
Only the fields present in the PATCH JSON will modify the original JSON Credential object. All other fields will remain unchanged.

Code Block

title	Current CredentialSample JSON Output
collapse	true

{
    "credentialScope	"credentialId": "INST"11004,
    "credentialInputsversionNumber": [1,
    "credentialName": "PUT Example  {Name",
            "versionNumber"isActive":1,
     true,
       "inputValuecredentialScope": "TestPass1999INST",
       "credentialStoreId": 11000,
    "credentialStoreInputDefIdcredentialInputs": 12010[
        } {
			"credentialId": 11004,
 ]
}

The PATCH request would then update the Credential with Id 11104 and return the following JSON Credential object.

Info
Only the fields present in the PATCH JSON will modify the original JSON Credential object. All other fields will remain unchanged.

Code Block

title	Sample JSON Output
collapse	true

{
	"credentialId": 11004			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-09T12:59:34.821+0000",
			"createdBy": "fdadmin",
			"createdOn": "2021-09-09T12:59:34.821+0000",
			"isEncrypted": true,
    "versionNumber": 1,        "credentialNameversionNumber":1,
"PUT Example Name",     "isActive": true,     "credentialScopeinputValue": "INST*****",
    "credentialStoreId": 11000,        "credentialInputscredentialStoreInputDefId": [
        {12000,
			"credentialInputId": 284895
        },
		 {
 			"versionNumbercredentialId":1 11004,
			"updatedBy": "fdadmin",
			"updatedOn": "2021-09-10T12:59:34.821+0000",
        "inputValue			"createdBy": "fdadmin",
			"createdOn": "TestPassword2021-09-10T12:59:34.821+0000",
            "credentialStoreInputDefId": 12000
        },
		{			"isEncrypted": true,
            "versionNumber":1,
            "inputValue": "TestPass1999*****",
            "credentialStoreInputDefId": 12010,
			"credentialInputId": 284872
        }
    ]
}

Versions Compared

Old Version 6

New Version Current

Key

Request

Response Codes

Example

GET by Query Parameters

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

Examples:

To Specify the

NAME parameter only:

To Specify the

NAME AND SCOPE parameters:

To Specify the name,

SCOPE, AND CREDENTIAL STORE ID parameters:

Response Codes

Response Codes

PUT

Request

PUT

Request

Response Codes

Response Codes

Example

PATCH

Request

Response Codes

Example

PATCH

Request

Response Codes

Example

Page Comparison

Versions Compared

Old Version 6

New Version Current

Key

Request

Response Codes

Example

GET by Query Parameters

Append the following character sequences to the above URL to specify Query parameters.

Use '&' between successive query parameters:

Examples:

To Specify the

NAME parameter only:

To Specify the

NAME AND SCOPE parameters:

To Specify the name,

SCOPE, AND CREDENTIAL STORE ID parameters:

Response Codes

Response Codes

PUT

Request

PUT

Request

Response Codes

Response Codes

Example

PATCH

Request

Response Codes

Example

PATCH

Request

Response Codes

Example