v1

latestOpenAPI 3.1.02026-08-06330343826.1 KB
Credential

Shared Credentials

Creates a new shared credential.

post/api/3/shared_credentials

Request body

descriptionstring

The description of the credential.

hostRestrictionstring

The host name or IP address that you want to restrict the credentials to.

idinteger

The identifier of the credential.

namestring required

The name of the credential.

portRestrictioninteger

Further restricts the credential to attempt to authenticate on a specific port.

siteAssignmentstring required

Assigns the shared scan credential either to be available to all sites or to a specific list of sites. The following table describes each supported value:

ValueDescription
"all-sites"The shared scan credential is assigned to all current and future sites.
"specific-sites"The shared scan credential is assigned to zero sites by default. Administrators must explicitly assign sites to the shared credential.
Shared scan credentials assigned to a site can disabled within the site configuration, if needed.
sitesinteger[]

List of site identifiers. These sites are explicitly assigned access to the shared scan credential, allowing the site to use the credential for authentication during a scan. This property can only be set if the value of property siteAssignment is set to "specific-sites". When the property siteAssignment is set to "all-sites", this property will be null.

Response

OK