Security Controls REST API

Home 

Credentials

Credentials consist of a user name and password pair. They are used to access specified target machines in order to perform scans and push any necessary files. You can define new scan credentials, locate existing credentials and delete credentials.

Base URL

https://<consoleFQDN:port>/st/console/api/v1.0/credentials

Supported Requests

Method URL Input Return

DELETE

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/{credential id}

 

Success code

     

GET

https://<consoleFQDN:port>/st/console/api/v1.0/credentials

 

User credential list

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/{credential id}

 

UserCredential

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/{credential name}

 

UserCredential

     

POST

https://<consoleFQDN:port>/st/console/api/v1.0/credentials

Request Body

UserCredential

     

PUT

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/{credential id}

Request Body

Success code

Input Model

Request Body

Name Required? Type Default Value Description

name

Yes

String

None

Provide a friendly name for this credential that describes exactly where it should be used.

password

Yes

Password

None

Provides the password that is associated with the UserName.

userName

Yes

String

None

Provide a user name that has access to the desired machines.

Password

Name Description

cipherText

Sets the encrypted password. The type of encryption is determined by ProtectionMode and SessionKey. Mutually exclusive with ClearText.

clearText

Sets the unencrypted password. Mutually exclusive with CipherText.

protectionMode

The type of data protection applied to the password for at-rest security.

sessionKey

Defines an encrypted session key used to protect the password in transit and at rest.

Example

Find all credentials created by the current user

GET Request

https://<consoleFQDN:port>/st/console/api/v1.0/credentials

Sample Response

{

"count": 1,

"value": [

{

"id": "01234567-89AB-CDEF-0123-456789ABCDEF",

"links": {

"self": {

"href": "https://device-name.fakedomain.com:3121/st/console/api/v1.0/credentials/01234567-89AB-CDEF-0123-456789ABCDEF"

}

},

"name": "JoesCreds",

"userName": "joe.andert"

}

]

}

Other Request Examples

Add a credential

https://<consoleFQDN:port>/st/console/api/v1.0/credentials

{

"name": "SampleName",

"password":{"ClearText": "SamplePW"},

"userName": "SampleName"

}

Find the credential named SampleCred

https://<consoleFQDN:port>/st/console/api/v1.0/credentials?name=SampleCred

Find the credential with ID 01234567-89AB-CDEF-0123-456789ABCDEF

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/01234567-89AB-CDEF-0123-456789ABCDEF

Delete the credential with ID 01234567-89AB-CDEF-0123-456789ABCDEF

https://<consoleFQDN:port>/st/console/api/v1.0/credentials/01234567-89AB-CDEF-0123-456789ABCDEF/usedby

 

Output Model

UserCredential

Name Type Description

name

String

A friendly name for this credential that describes exactly where it should be used.

password

Password

The password that is associated with the UserName.

userName

String

A user name that has access to the desired machines.

id

Guid

The unique credential identifier that was automatically assigned to the credential. This is read only.

links

Links

Shows the related URL for the credential.


Was this article useful?    

The topic was:

Inaccurate

Incomplete

Not what I expected

Other