Overview
Torii integrates with F5 Networks (F5 Distributed Cloud) and syncs:
- Users, including their email, name, role, status, and last login
- Licenses: one F5 Networks license for every synced user
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- An F5 Distributed Cloud tenant on an Organization plan. Your console address includes your tenant name.
- An administrator who can create credentials in the F5 Distributed Cloud Console.
- A credential whose role can read the tenant's users. To run the Torii actions, the role must also be allowed to create users, assign roles, and delete users.
Required keys
- Tenant Name - the first part of your console address. For https://acmecorp.console.ves.volterra.io, the tenant name is acmecorp.
- API Token - an F5 Distributed Cloud API token.
How to Generate the Required Values
Step 1: Find your tenant name
- Sign in to the F5 Distributed Cloud Console.
- Look at the address in your browser. The tenant name is the part before .console.ves.volterra.io.
Step 2: Create an API token
Choose one of the following options.
Option A: Service Credential with limited roles
- In the F5 Distributed Cloud Console, go to Administration > IAM > Service Credentials.
- Click Add Service Credentials.
- Select API Token as the credential type.
- Assign only a role that can read users (for example, a role that includes user management access). Do not assign more roles than you need.
- Set an expiration and generate the token.
- Copy the token.
Option B: Personal API token
This works, but the token has all the roles of the user who creates it, which is more access than Torii needs.
- In the F5 Distributed Cloud Console, go to Administration > Personal Management > Credentials.
- Click Add Credentials.
- Select API Token as the credential type.
- Set an expiration and generate the token.
- Copy the token.
Important
Copy the token when it is generated. API tokens expire, so create a new one and reconnect before it does.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for F5 Networks and click Connect.
- Enter the Tenant Name and the API Token.
- Click Connect.
Actions
- Create F5 Networks user - creates a user in your tenant with the role you choose. You choose whether the user is managed by F5 or signs in through SSO (SSO must be enabled on your tenant).
- Delete F5 Networks user - deletes the user from your tenant.
- Assign F5 Networks role to user - adds a role to a user. It does not remove the roles the user already has.
For any further questions, please contact Torii Support.