Catalyst SD-WAN Credentials

Choosing credentials

Catalyst SDWAN Endpoint targets support the following account key types:

• Catalyst SDWAN Token-Based Credentials: Use this option with Catalyst SD-WAN Release 20.18.1 or later and an API token generated from the user profile.
• Catalyst SDWAN Password-Based Credentials: Use this option with a Catalyst SD-WAN username and password, including releases earlier than 20.18.1.

Token-based credentials

To generate an API token:

1. In Catalyst SD-WAN, select Administration > Settings.
2. Select your username, and then open My Profile.
3. Open API token.
4. Select Generate.
5. Copy or download the generated token.

For more information, see JWT-based authentication.

Complete the following steps to create a Catalyst SDWAN Token-Based Credentials account key:

1. From the left navigation menu, select Automation > Targets.
2. From the Account Keys tab, select New account key.
3. On the New Account Key page, select Catalyst SDWAN Token-Based Credentials from the Account Key Type list.
4. Enter a display name in Display Name and a brief description in Description.
5. In the Credentials area, enter the following information:
   • API Token: Paste the generated API token. Do not add a Bearer prefix or provide a separate CSRF token, XSRF token, or session cookie.
6. Select Save.

Password-based credentials

Complete the following steps to create a Catalyst SDWAN Password-Based Credentials account key:

1. From the left navigation menu, select Automation > Targets.
2. From the Account Keys tab, select New account key.
3. On the New Account Key page, select Catalyst SDWAN Password-Based Credentials from the Account Key Type list.
4. Enter a display name in Display Name and a brief description in Description.
5. In the Credentials area, enter the following information:
   • Catalyst SDWAN Username: Enter the Catalyst SD-WAN username.
   • Catalyst SDWAN Password: Enter the password for the specified username.
6. Select Save.