An Okta Privileged Access project is a collection of resources that share settings.
See Projects.
Lists all projects in the specified resource group
OK
{- "list": [
- {
- "active_resource_count": 50,
- "create_server_users": true,
- "deleted_at": "2019-08-24T14:15:22Z",
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "id": "/regex/",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0,
- "team": "Your_OPA_Team",
- "user_on_demand_period": 4294967295
}
]
}
Creates a project in the specified resource group
Created
{- "active_resource_count": 50,
- "create_server_users": true,
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0
}
{- "active_resource_count": 50,
- "create_server_users": true,
- "deleted_at": "2019-08-24T14:15:22Z",
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "id": "/regex/",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0,
- "team": "Your_OPA_Team",
- "user_on_demand_period": 4294967295
}
Retrieves a project from a resource group
OK
{- "active_resource_count": 50,
- "create_server_users": true,
- "deleted_at": "2019-08-24T14:15:22Z",
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "id": "/regex/",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0,
- "team": "Your_OPA_Team",
- "user_on_demand_period": 4294967295
}
Updates a project in a resource group
OK
{- "active_resource_count": 50,
- "create_server_users": true,
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0
}
{- "active_resource_count": 50,
- "create_server_users": true,
- "deleted_at": "2019-08-24T14:15:22Z",
- "force_shared_ssh_users": true,
- "gateway_selector": "REGION=WEST-EU,TEAM=MARKETING",
- "id": "/regex/",
- "name": "/regex/",
- "next_unix_gid": 100,
- "next_unix_uid": 100,
- "persistent_server_user_accounts": null,
- "require_preauth_for_creds": true,
- "resource_group_id": "5f3159e9-e7ab-428e-8a87-c2ebffe407f6",
- "server_account_management": true,
- "shared_admin_user_name": "Server.Admin",
- "shared_standard_user_name": "Server.User",
- "ssh_certificate_type": "CERT_TYPE_ECDSA_256_01",
- "stale_resource_count": 0,
- "team": "Your_OPA_Team",
- "user_on_demand_period": 4294967295
}
Deletes a project from a resource group
No Content
Lists all the resources that are currently checked out within a specified resource group project.
OK
{- "list": [
- {
- "checkin_by": "/regex/",
- "checkin_start_at": "2019-08-24T14:15:22Z",
- "checkin_type": "admin",
- "checkout_at": "2019-08-24T14:15:22Z",
- "checkout_expiry_at": "2019-08-24T14:15:22Z",
- "resource_details": {
- "hostname": "string",
- "server_id": "/regex/",
- "_type": "string"
}, - "resource_id": "string",
- "resource_name": "string",
- "resource_type": "managed_saas_app_account_password_login",
- "checkout_by_username": "string",
- "resource_status": "checked_out"
}
]
}
Enables admins to forcefully check in a resource. This is used when a resource is checked out but needs to be returned or made available regardless of the user who checked it out.
No Content
{- "resource_id": "string",
- "resource_type": "managed_saas_app_account_password_login"
}
Retrieves the checkout settings configured for a project, specific to the Okta Universal Directory resource type.
OK
Update the checkout settings configured for a project, specific to the Okta Universal Directory resource type.
No Content
Retrieves the checkout settings configured for a project, specific to the SaaS Application resource type.
OK
Update the checkout settings configured for a project, specific to the SaaS Application resource type.
No Content
Lists all server accounts in a resource group project
OK
{- "list": [
- {
- "created_at": "2019-08-24T14:15:22Z",
- "deleted_at": "2019-08-24T14:15:22Z",
- "hostname": "string",
- "id": "string",
- "last_password_change_error_metadata": "string",
- "last_password_change_error_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_system_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_type": "string",
- "last_password_change_success_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_system_timestamp": "2019-08-24T14:15:22Z",
- "login": "string",
- "managed": true,
- "project_id": "string",
- "server_id": "string",
- "team_id": "string"
}
]
}
Retrieves a server account from a project in a resource group
OK
{- "items": {
- "created_at": "2019-08-24T14:15:22Z",
- "deleted_at": "2019-08-24T14:15:22Z",
- "hostname": "string",
- "id": "string",
- "last_password_change_error_metadata": "string",
- "last_password_change_error_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_system_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_type": "string",
- "last_password_change_success_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_system_timestamp": "2019-08-24T14:15:22Z",
- "login": "string",
- "managed": true,
- "project_id": "string",
- "server_id": "string",
- "team_id": "string"
}
}
Retrieves the checkout settings configured for a project, specific to the server resource type.
OK
{- "checkout_duration_in_seconds": 900,
- "checkout_required": true,
- "exclude_list": [
- "string"
], - "include_list": [
- "string"
]
}
Update the checkout settings configured for a project, specific to the server resource type
No Content
{- "checkout_duration_in_seconds": 900,
- "checkout_required": true,
- "exclude_list": [
- "string"
], - "include_list": [
- "string"
]
}
Lists all server enrollment tokens in a resource group project
OK
{- "list": [
- {
- "created_by_user": "string",
- "description": "string",
- "id": "/regex/",
- "issued_at": "2019-08-24T14:15:22Z",
- "token": {
- "property1": "string",
- "property2": "string"
}
}
]
}
Creates a server enrollment token for a project in a resource group
Created
{- "description": "string"
}
{- "created_by_user": "string",
- "description": "string",
- "id": "/regex/",
- "issued_at": "2019-08-24T14:15:22Z",
- "token": {
- "property1": "string",
- "property2": "string"
}
}
Retrieves a server enrollment token from a project in a resource group
OK
{- "created_by_user": "string",
- "description": "string",
- "id": "/regex/",
- "issued_at": "2019-08-24T14:15:22Z",
- "token": {
- "property1": "string",
- "property2": "string"
}
}
Deletes a server enrollment token from a project in a resource group
No Content
Retrieves a password policy for a project in a resource group
OK
{- "character_options": {
- "upper_case": true,
- "lower_case": true,
- "digits": true,
- "punctuation": true,
- "require_from_each_set": true
}, - "enable_periodic_rotation": true,
- "managed_privileged_accounts_config": [
- "string"
], - "max_length_in_bytes": 0,
- "min_length_in_bytes": 0,
- "modified_at": "2019-08-24T14:15:22Z",
- "periodic_rotation_duration_in_seconds": 0
}
Updates a password policy for a project in a resource group
OK
{- "character_options": {
- "upper_case": true,
- "lower_case": true,
- "digits": true,
- "punctuation": true,
- "require_from_each_set": true
}, - "enable_periodic_rotation": true,
- "managed_privileged_accounts_config": [
- "string"
], - "max_length_in_bytes": 0,
- "min_length_in_bytes": 0,
- "periodic_rotation_duration_in_seconds": 0
}
{- "character_options": {
- "upper_case": true,
- "lower_case": true,
- "digits": true,
- "punctuation": true,
- "require_from_each_set": true
}, - "enable_periodic_rotation": true,
- "managed_privileged_accounts_config": [
- "string"
], - "max_length_in_bytes": 0,
- "min_length_in_bytes": 0,
- "modified_at": "2019-08-24T14:15:22Z",
- "periodic_rotation_duration_in_seconds": 0
}
Lists all server accounts for a server in a project
OK
{- "list": [
- {
- "created_at": "2019-08-24T14:15:22Z",
- "deleted_at": "2019-08-24T14:15:22Z",
- "hostname": "string",
- "id": "string",
- "last_password_change_error_metadata": "string",
- "last_password_change_error_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_system_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_error_type": "string",
- "last_password_change_success_report_timestamp": "2019-08-24T14:15:22Z",
- "last_password_change_system_timestamp": "2019-08-24T14:15:22Z",
- "login": "string",
- "managed": true,
- "project_id": "string",
- "server_id": "string",
- "team_id": "string"
}
]
}