Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


The credential credentials API provides functionality that allows a administrator to add, delete or update credentials

toc
Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

Filter returned credentials to only those whose description matches the given expression
Section
List

Get all credentials

Lists all the credentials configured in the Aspire, this endpoint need the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb
GET /aspire/_api/credential

Query String Parameters

NameTypeRequiredDescription
typestringOptionalFilter returned credentials to only those with the given type
descriptionstringOptional
credentials

Pagination query string parameters

Sorting query string parameters

Section

Get all credentials, filtered

Lists credentials configured in the Aspire, filtered by a specified criteria, this endpoint need the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/credentials/getAll

Pagination query string parameters

Sorting query string parameters

Filters: The credential filter definition here

Response

Code Block
languagejs
themeRDark
{
    "count": {
        "totalItems": 1
    },
    "credential": [
        {
            "id": "AAABcID5GBc=40b305ea-77e1-4874-aa28-964b1cf4a1a8",
            "type": "filesystem",
            ...
  },
  {
 "description": "xxxx",
            "throttlePolicy": "10653921-1b27-40b5-9d7a-f54ef1e3ad01",
            "properties": {
                "iddomain": "AAABcIueWUc=xxxx",
    "type            "user": "filesystemxxxx",
        ...
      }],
  "messagepassword": "optional response message"xxxx"
            }
        }
    ]
}

Status

Response codeDescription

: 200

Success




Section

Get a single credential

Get information about a single credential configured in Aspire, this endpoint need the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

GET /aspire_api/credential?id=:idGET /aspire_api/credentialcredentials/:id


Query String and Path Parameters

NameTypeRequiredDescription
idstringRequiredThe id of the credential to return


Response

Code Block
languagejs
themeRDark
{
    "credential": {
        "id": "AAABcID5GBc=40b305ea-77e1-4874-aa28-964b1cf4a1a8",
        "type": "filesystem",
    ...
 },

  "message": "optional response message"
}

Status

Response codeDescription
200Success
404The given credentials id was not found
    "description": "xxxx",
        "throttlePolicy": "10653921-1b27-40b5-9d7a-f54ef1e3ad01",
        "properties": {
            "domain": "xxxx",
            "user": "xxxx",
            "password": "xxxx"
        }
    }
}

Status: 200, 404




Section

Add credential(s)

Adds credentials to Aspire, this endpoint need the ADMINISTRATOR role to be executed.

Section

Add credential(s)

Add one or more credentials to Aspire

Panel
borderColorblack
bgColor#fafafb
POST /aspire/_api/credentialcredentials


Request Body Parameters

NameTypeRequiredDescription
typestringRequiredThe type of credential to add
descriptionstringOptionalRequiredAn optional description of the credential

Other parameters passed in the request body will depend on the type of credential being created - those required by Documentum will be different from those required by SharePoint. Some candidates are shown below

NameDescription
domainAn Active Directory/LDAP domain
usernameA username
passwordA password
emailA user email address
APIkeyAn API key
tokenan access token
throttlePolicystringOptionalThe throttle policy id
propertiesstringRequiredCredential properties


Example

Examples

Add a single credential

Code Block
languagejs
themeRDark
POST /aspire/_api/credentials
{
    "type": "filesystem",
    "description": "Europe Net Appliancexxxx",
  ...
}

Add multiple credentials

Code Block
languagejs
[{
  "typeproperties": "filesystem"{
  "description      "domain": "Europe Net Appliance"
  ...
},
{
"xxxx",
        "typeuser": "sharepointxxxx",
  "description      "password": "SP Onlinexxxx"
  ...  }
}]


Response

Code Block
languagejs
themeRDark
{
    "credential": [
        {
            "id": "AAABcID5GBc=43d1a498-c672-46b7-902f-082222122481",
            "type": "filesystem",
            "description": "Europe Net Appliance"
xxxx",
            "properties": {
      ...
   },
   {
    "iddomain": "AAABcIueWUc=xxxx",
                "typeuser": "sharepointxxxx",
          "description      "password": "SP Onlinexxxx"
           ...
 }
        }],
  "message": "optional response message" ]
}

Status

Response codeDescription201Created406Not acceptable - there was an issue validating the input

See Response Body for details regarding the response body returned where multiple items are affected with some (or all) returning errors

Status: 201, 406




Not acceptable - there was an issue validating the input
Section

Update credential(s)

Update one or more credentials in Aspire. Updates will be treated as partial updates rather than overwrites. If a field is not present in the input, any previous value will remain after the update. If you wish to "delete" a value, pass a value of null, this endpoint needs the ADMINISTRATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

PUT /aspire/_api/credentials/:id

PUT /aspire/_api/

credential

credentials

Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier of the credential to update
typedescriptionstringRequiredxThe type description of the credential
propertiesobjectxCredential properties
throttlePolicydescriptionstringOptionalAn optional description of the credential

Other parameters passed in the request body will depend on the type of credential being created - see Credential API above

Examples

Update a single credential

xThe throttle policy id

x - at least one field must be present

Example - update more credentials

Code Block
languagejs
themeRDark
PUT /aspire/_api/credentials
{
  "AAABcID5GBc=": {
    "id": "AAABcID5GBc=",
    "typethrottlePolicy": "filesystem10653921-1b27-40b5-9d7a-f54ef1e3ad01"
  "description},
  "AAABcID5GBd=": "Europe Net Appliance"{
  ...
}

Update multiple credentials

Code Block
languagejs
[{
  "id": "AAABcID5GBcAAABcID5GBd=",
    "typeproperties": "filesystem"{
       "descriptiondomain": "Europexxxx",
  Net Appliance"
  ...
},
{
  "iduser": "AAABcIueWUc=xxxx",
       "typepassword": "sharepointxxxx"
  "description": "SP Online"}
  ...}
}]


Response

Code Block
languagejs
themeRDark
{
  "credential": [{
    "updated":true,"id": "AAABcID5GBc="},{"updated":true,"id":"AAABcID5GBd="}]}

Status: 200, 404, 406


Section

Update credentials, filtered

Update credentials configured in the Aspire, filtered by a specified criteria, this endpoint needs the  ADMINISTRATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

PUT /aspire/_api/credentials/updateAll

Filters: The credential filter definition here

Update body parameter

Code Block
themeRDark
{
  
"
type
update" : 
"filesystem"
{
    "description" : "
Europe Net Appliance" ... }
DESCRIPTION",
   
{
 
"
id
throttlePolicy" : "
AAABcIueWUc=
THROTTLE_POLICY_ID",
    "
type
properties": 
"sharepoint"
{
      "
description
user": "
SP Online
true",
      .....
    }
  
}],
}
}

Response

Code Block
languagejs
themeRDark
{
  "message": "
optional
update result response message"
}

Status

Response codeDescription
201Created
404Not found - a given credential identifier was not found
406

: 200, 406




Section

Delete credential(s)

Delete one or more credentials connectors from Aspire, this endpoint need the ADMINISTRATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

DELETE /aspire/_api/credential?id=credentials/:id

DELETE /aspire/_api/credential/:idcredentials

POST DELETE /aspire/_api/credentialcredentials/delete


Path Parameters and Query parametersQuery String, Path and Request Body Parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the credential(s) to delete

Examples


Body Parameter

NameTypeRequiredDescription
idsstringRequiredThe identifier(s) of the credential(s) to delete


ExamplesDelete a single credential

Code Block
languagejs
themeRDark
DELETE /aspire/_api/credentials/AAABcID5GBc

DELETE /aspire/_api/credentials?id=AAABcID5GBc&id=AAABcID5GBd

POST /aspire/_api/credentials/delete
{
  "idids": ["AAABcID5GBc=","AAABcID5GBd"]
}


Delete multiple credentialsResponse

Code Block
languagejs
themeRDark
[{
  "idmessage": "AAABcID5GBc=delete result response message"
},

Status: 200, 404, 406


Section

Delete multiple credentials, filtered

Delete multiple credentials from Aspire, filtered by a specified criteria, this endpoint need the ADMINISTRATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/credentials/deleteAll

Filters: The credential filter definition here

Response

Code Block
languagejs
themeRDark
{
  "
id
message": "
AAABcIueWUc=" }]

Delete multiple credentials (alternative form)

delete result response message"
}

Status: 200




Not acceptable - there was an issue validating the input
Section

Export credentials(s)

Export one or more credential from Aspire, this endpoint needs at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

GET /aspire/_api/credentials/export

GET /aspire/_api/credentials/export/:id

POST /aspire/_api/credentials/exportAll

Info

Every configuration item has the option to export from the UI, using the single menu or by the bulk actions:

Image AddedImage Added

Note

Something important that you need to know is that when you export a config item that depends on another, the export will contain also all the dependencies.

Note

Take into consideration that components with resources loaded into elastic, will be exported, but the resource itself will not, so you will need to reupload the resource and go and select your resource in the component again.


Path Parameters and Query parameters

NameTypeRequiredDescription
idstringRequiredThe identifier(s) of the credential(s) to export


Body Parameter

NameTypeRequiredDescription
idsstringRequiredThe identifier(s) of the credential(s) to export


Examples

Code Block
languagejs
themeRDark
GET /aspire/_api/credentials/export/AAABcID5GBc

DELETE /aspire/_api/credentials/export?id=AAABcID5GBc&id=AAABcID5GBd

POST /aspire/_api/credentials/export
{
  "ids":["AAABcID5GBc","AAABcID5GBd"]
}
Code Block
languagejs
{
  "id": ["AAABcID5GBc=", "AAABcIueWUc="]
}


Response

Code Block
languagejs
themeRDark
{
  "message": "optional response message"
}

Status

Response codeDescription
200Success
404Not found - a given credential identifier was not found
406
export": {
    "credentials": {
      "credential": [
        {
          "id": "<credential_id>",
          "type": "rest-api",
          "description": "REST",
          "properties": {
            "type": "bearer",
            "query": {
              ...
            }
          }
        },
		...
      ]
    }
  }
}

Status: 200, 404, 406


Section

Export multiple credentials, filtered

Export multiple credentials from Aspire, filtered by a specified criteria, this endpoint needs at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/credentials/exportAll

Filters: The connection filter definition here

Response

Code Block
languagejs
themeRDark
{
  "export": {
    "credentials": {
      "credential": [
        {
          "id": "<credential_id>",
          "type": "rest-api",
          "description": "REST",
          "properties": {
            "type": "bearer",
            "query": {
              ...
            }
          }
        },
		...
      ]
    }
  }
}

Status: 200




Section

Import

The import usage can be found here





Section

Filters
Anchor
FiltersAnchor
FiltersAnchor

Credential filter:

Code Block
languagejs
themeRDark
{ 
 "filter" : {
    "ids" : ["ID1", "ID2", "ID3", ...],
    "type" : "TYPE",
    "description" : "DESCRIPTION",
	"throttlePolicy" : "THROTTLE_POLICY_ID"
  }
}