Type: | integer [seconds] |
Description: Used for communication between plugins. This is an interactive request/response right after authentication in order to supply data to credential store plugins. The question is transferred to the session cookie and all hooks of all plugins receive it.
For example, if you have an external authenticator app, you do not have to wait for the question to be prompted but can authenticate with a one-time password:
ssh otp=123456@root@scb
Name subsequent questions with the appropriate number, for example, [question_1], [question_2], and so on.
For details, see "Performing authentication with AA plugin in terminal connections" in the Administration Guide and "Performing authentication with AA plugin in Remote Desktop connections" in the Administration Guide.
Type: | string |
Required: | yes |
Default: | N/A |
Description: The name of the name-value pair.
Type: | string |
Required: | yes |
Default: | N/A |
Description: The question itself in text format.
Type: | boolean yes|no |
Required: | no |
Default: | no |
Description: Whether the answer to the question is visible (yes), or replaced with asterisks (no).
By default, the configuration of the plugin is stored on SPS in the configuration of SPS. Make sure that you store the sensitive parameters (for example, api_key) of the plugin in an encrypted way.
To store sensitive plugin data securely
The following describes how toLog in to SPS and create a local Credential Store. For details, see "Configuring local Credential Stores" in the Administration Guide.
Instead of usernames and passwords, you will store the configuration parameters of the plugin in this Credential Store.
Add the plugin parameters you want to store in an encrypted way to the Credential Store. You can store any configuration parameter of the plugin in the Credential Store, but note that if an option appears in the Credential Store, the plugin will use it. If the same parameter appears in the configuration of the plugin, it will be ignored.
Enter the name of the configuration section without the brackets in the HOST field (for example, okta).
Enter the name of the plugin parameter in the USERNAME field (for example, api_key).
Enter the value of the plugin parameter in the PASSWORD field.
Commit your changes, and navigate to the configuration of the plugin on the Policies > AA Plugin Configurations page.
In the plugin configuration file, enter the name of the local Credential Store under the [plugin] section, in the cred_store parameter.
The following describes how to establish a terminal connection (SSH, TELNET, or TN3270) to a server.
To establish a terminal connection (SSH, TELNET, or TN3270) to a server
Connect to the server.
If you can authenticate using an OTP or token, encode the OTP as part of the username. You can use the @ as a field separator. For example:
ssh otp=YOUR-ONE-TIME-PASSWORD@user@server
Replace YOUR-ONE-TIME-PASSWORD with your actual OTP. If needed, you can specify the type of OTP as a prefix to the OTP. For example, to specify the OTP of a YubiKey token:
ssh otp=y_YOUR-ONE-TIME-PASSWORD@user@server
Google Authenticator: g
inWebo Authenticator: o
Symantec token: s
YubiKey: y
RSA token: r
If you need to authenticate using the Okta Verify push notification, approve the connection in your mobile app.
If SPS prompts you for further information, enter the requested information. If you need to authenticate with an OTP, but you have not supplied the OTP in your username, you will be prompted to enter the OTP.
Authenticate on the server.
If authentication is successful, you can access the server.
The following describes how to establish a Remote Desktop (RDP) connection to a server when the AA plugin is configured.
To establish a RDP connection to a server when the AA plugin is configured
Open your Remote Desktop client application.
If you have to provide additional information to authenticate on the server, you must enter this information in your Remote Desktop client application in the User name field, before the regular content (for example, your username) of the field.
If you can authenticate using an OTP or token, encode the OTP as part of the username. To encode additional data, you can use the following special characters:
% as a field separator
~ as the equal sign
^ as a colon (for example, to specify the port number or an IPv6 IP address)
For example, use the following format:
domain\otp~YOUR-ONE-TIME-PASSWORD%Administrator
Replace YOUR-ONE-TIME-PASSWORD with your actual OTP. If needed, you can specify the type of OTP as a prefix to the OTP. For example, to specify the OTP of a YubiKey token: domain\otp~y_YOUR-ONE-TIME-PASSWORD%Administrator
Google Authenticator: g
inWebo Authenticator: o
Symantec token: s
YubiKey: y
RSA token: r
Connect to the server.
If you need to authenticate using the Okta Verify push notification, approve the connection in your mobile app.
Authenticate on the server.
If authentication is successful, you can access the server.
© 2024 One Identity LLC. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center