API v2: External Password Repositoryยถ
Fudo Enterprise supports external passwords repositories for managing passwords to monitored servers.
Data Structuresยถ
Attribute |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Unique, read-only object identifier. |
|
|
string |
yes |
Unique, case insensitive object name |
|
string |
yes |
URL to the passwords serverโs API |
|
string {cyberark, laps, thycotic} |
yes |
Immutable |
|
string |
If |
|
|
string |
If |
Protected |
|
string |
Value format: x509-certificate |
|
|
string |
If |
|
|
string |
If |
|
|
string |
If |
|
|
string |
If |
|
|
string |
Value format: x509-certificate |
|
|
string |
Protected. Value format: private-key |
|
|
string |
If |
Protected. Passphrase to use to decrypt private key. |
|
datetime |
Read-only |
|
|
datetime |
Read-only |
|
|
string |
Read-only |
Retrieve Available Attributes of the PassvnModelยถ
Request
Method |
|
Path |
|
To check allowed methods, available URL parameters and possible responses please refer to the API Overview section.
Create External Password Repositoryยถ
Request
Method |
|
Path |
|
Headers |
|
Body |
|
Example Request
POST /api/v2/passvn`
{
"type": "laps",
"name": "LAPS Test Name 2",
"url": "ldaps://10.2.0.1:8636/",
"login": "cn=admin,dc=fudosecurity,dc=lab",
"secret": "passwordExample",
"base_dn": "dc=fudosecurity,dc=lab"
}
Response
{
"result": "success",
"passvn": {
"id": "123456789012345678"
}
}
Get External Password Repositories Listยถ
Request
Method |
|
Path |
|
Example Request
GET /api/v2/passvn`
Response
"result": "success",
"passvn": [
{
"id": "123456789012345679",
"name": "LDAP Test Name",
"url": "ldaps://10.2.0.100:8636/",
"type": "laps",
"login": "cn=admin,dc=fudosecurity,dc=lab",
"base_dn": "dc=fudosecurity,dc=lab",
"created_at": "2023-06-16 02:53:08.930597-07",
"modified_at": "2023-06-16 02:53:08.930597-07"
}
]
Get Information About External Password Repository byย IDยถ
Request
Method |
|
Path |
|
Example Request
GET /api/v2/passvn/<id>`
Response
"result": "success",
"passvn": [
{
"id": "123456789012345679",
"name": "LDAP Test Name",
"url": "ldaps://10.2.0.100:8636/",
"type": "laps",
"login": "cn=admin,dc=fudosecurity,dc=lab",
"base_dn": "dc=fudosecurity,dc=lab",
"created_at": "2023-06-16 02:53:08.930597-07",
"modified_at": "2023-06-16 02:53:08.930597-07"
}
]
Delete an External Password Repository Definitionยถ
Request
Method |
|
Path |
|
Changing External Password Repository Configurationยถ
Request
Method |
|
Path |
|
Headers |
|
Body |
|
Example Request
PATCH /api/v2/passvn/<id>`
{
"login": "cn=admin,dc=fudosecurity,dc=com",
"base_dn": "dc=fudosecurity,dc=com"
}
Response
{
"result": "success"
}