Managed Account Credentials

Quick Navigation

PUT ManagedAccounts/{managedAccountID}/Credentials

Updates the credentials for a Managed Account, optionally applying the change to the Managed System.

  • Password Safe Account Management (Read/Write) or
  • ISA Role or Credentials Manager Role on a Smart Rule referencing the account.

managedAccountID: ID of the Managed Account for which to set the credentials.

Content-Type: application/json

{
    Password: string, 
    PublicKey: string, 
    PrivateKey: string, 
    Passphrase: string, 
    UpdateSystem: bool
}
  • Password: (optional) The new password to set. If not given, generates a new random password.
  • PublicKey: (required if PrivateKey is given and updateSystem=true) The new public key to set on the host.
  • PrivateKey: The private key to set (provide Passphrase if encrypted).
  • Passphrase: (optional) The passphrase to use for an encrypted private key.
  • UpdateSystem: (default: true) Whether to update the credentials on the referenced system.

None

204 - Request successful. No content in body.

For more information, please see Common Response Codes.

PUT Credentials?workgroupName={workgroupName}&assetName={assetName}&accountName={accountName}

Updates the credentials for a Managed Account by Workgroup name, Asset name, and Managed Account name, optionally applying the change to the Managed System.

  • Password Safe Account Management (Read/Write) or
  • ISA Role or Credentials Manager Role on a Smart Rule referencing the account.
  • workgroupName: Name of the Workgroup.
  • assetName: Name of the Asset.
  • accountName: Name of the Managed Account for which to set the credentials.

Content-Type: application/json

{
    Password: string,
    PublicKey: string,
    PrivateKey: string,
    Passphrase: string,
    UpdateSystem: bool
}
  • Password: (optional) The new password to set. If not given, generates a new random password.
  • PublicKey: (required if PrivateKey is given and updateSystem=true) The new public key to set on the host.
  • PrivateKey: The private key to set (provide Passphrase if encrypted).
  • Passphrase: (optional) The passphrase to use for an encrypted private key.
  • UpdateSystem: (default: true) Whether to update the credentials on the referenced system.

None

204 - Request Successful. No Response Body.

For more information, please see Common Response Codes.

POST ManagedAccounts/{managedAccountID}/Credentials/Test

Tests the current credentials of a Managed Account.

Password Safe Account Management (Read/Write)

managedAccountID: ID of the Managed Account.

None

Content-Type: application/json

{
    Success : bool
}

Success: True if the credential test succeeded, otherwise false.

200 - Request Successful.

For more information, please see Common Response Codes.

POST ManagedAccounts/{managedAccountID}/Credentials/Change

Changes the current Credentials of a Managed Account.

Password Safe Account Management (Read/Write)

managedAccountID: ID of the Managed Account.

Content-Type: application/json

{
    Queue : bool
}

Queue: (default: false) True to queue the change for background processing, otherwise false. When Queue is false the credentials change is immediate.

None

204 - Request successful. No content in body.

For more information, please see Common Response Codes.

POST ManagedSystems/{systemId}/ManagedAccounts/Credentials/Change

Queues Credentials' changes for all active Managed Accounts for a Managed System.

Password Safe API Global Quarantine (Read/Write)

systemId: ID of the Managed System.

None

None

204 - Request successful. No content in body.

For more information, please see Common Response Codes.