b76a56d40c
* migrates nav data format and updates docs pages * removes sidebar_title from content files
119 lines
3.2 KiB
Plaintext
119 lines
3.2 KiB
Plaintext
---
|
||
layout: api
|
||
page_title: /sys/mfa/method/okta - HTTP API
|
||
description: >-
|
||
The '/sys/mfa/method/okta' endpoint focuses on managing Okta MFA behaviors in
|
||
Vault Enterprise.
|
||
---
|
||
|
||
## Configure Okta MFA Method
|
||
|
||
This endpoint defines a MFA method of type Okta.
|
||
|
||
| Method | Path |
|
||
| :----- | :--------------------------- |
|
||
| `POST` | `/sys/mfa/method/okta/:name` |
|
||
|
||
### Parameters
|
||
|
||
- `name` `(string: <required>)` – Name of the MFA method.
|
||
|
||
- `mount_accessor` `(string: <required>)` - The mount to tie this method to for use in automatic mappings. The mapping will use the Name field of Aliases associated with this mount as the username in the mapping.
|
||
|
||
- `username_format` `(string)` - A format string for mapping Identity names to MFA method names. Values to substitute should be placed in `{{}}`. For example, `"{{alias.name}}@example.com"`. If blank, the Alias's Name field will be used as-is. Currently-supported mappings:
|
||
|
||
- alias.name: The name returned by the mount configured via the `mount_accessor` parameter
|
||
- entity.name: The name configured for the Entity
|
||
- alias.metadata.`<key>`: The value of the Alias's metadata parameter
|
||
- entity.metadata.`<key>`: The value of the Entity's metadata parameter
|
||
|
||
- `org_name` `(string)` - Name of the organization to be used in the Okta API.
|
||
|
||
- `api_token` `(string)` - Okta API key.
|
||
|
||
- `base_url` `(string)` - If set, will be used as the base domain for API requests. Examples are okta.com, oktapreview.com, and okta-emea.com.
|
||
|
||
- `primary_email` `(bool: false)` - If set, the username will only match the primary email for the account.
|
||
|
||
### Sample Payload
|
||
|
||
```json
|
||
{
|
||
"mount_accessor": "auth_userpass_1793464a",
|
||
"org_name": "dev-262778",
|
||
"api_token": "0081u7KrReNkzmABZJAP2oDyIXccveqx9vIOEyCZDC"
|
||
}
|
||
```
|
||
|
||
### Sample Request
|
||
|
||
```shell-session
|
||
$ curl \
|
||
--header "X-Vault-Token: ..." \
|
||
--request POST \
|
||
--data @payload.json \
|
||
http://127.0.0.1:8200/v1/sys/mfa/method/okta/my_okta
|
||
```
|
||
|
||
## Read Okta MFA Method
|
||
|
||
This endpoint queries the MFA configuration of Okta type for a given method
|
||
name.
|
||
|
||
| Method | Path |
|
||
| :----- | :--------------------------- |
|
||
| `GET` | `/sys/mfa/method/okta/:name` |
|
||
|
||
### Parameters
|
||
|
||
- `name` `(string: <required>)` – Name of the MFA method.
|
||
|
||
### Sample Request
|
||
|
||
```shell-session
|
||
$ curl \
|
||
--header "X-Vault-Token: ..." \
|
||
--request GET \
|
||
http://127.0.0.1:8200/v1/sys/mfa/method/okta/my_okta
|
||
|
||
```
|
||
|
||
### Sample Response
|
||
|
||
```json
|
||
{
|
||
"data": {
|
||
"api_token": "0081u7KrReNkzmABZJAP2oDyIXccveqx9vIOEyCZDC",
|
||
"id": "e39f08a1-a42d-143d-5b87-15c61d89c15a",
|
||
"mount_accessor": "auth_userpass_1793464a",
|
||
"name": "my_okta",
|
||
"org_name": "dev-262778",
|
||
"production": true,
|
||
"type": "okta",
|
||
"username_format": ""
|
||
}
|
||
}
|
||
```
|
||
|
||
## Delete Okta MFA Method
|
||
|
||
This endpoint deletes a Okta MFA method.
|
||
|
||
| Method | Path |
|
||
| :------- | :--------------------------- |
|
||
| `DELETE` | `/sys/mfa/method/okta/:name` |
|
||
|
||
### Parameters
|
||
|
||
- `name` `(string: <required>)` - Name of the MFA method.
|
||
|
||
### Sample Request
|
||
|
||
```shell-session
|
||
$ curl \
|
||
--header "X-Vault-Token: ..." \
|
||
--request DELETE \
|
||
http://127.0.0.1:8200/v1/sys/mfa/method/okta/my_okta
|
||
|
||
```
|