Overview

To allow Fletch to retrieve Okta events, you need to perform the following actions:

  1. Create Okta user for use with Fletch. You may skip this step and re-use an existing account as needed.
  2. Assign Read-only Administrator role to the user you created. You may reuse an existing user with Okta Administrator or Read-only Administrator role but we strongly recommend using a read-only role for extra security.
  3. Create an API token for the Read-only Administrator/Administrator account

Section 1: Create Okta user for use with Fletch

Please skip to the Section 2 if you already have a user that will be used for Fletch access.

Step 1. Login to your Okta admin dashboard using an Okta Administrator account (example https://dev-12345-admin.okta.com/ - you organization will have it’s own unique Okta URL).

Step 2. In the left page menu access Directory → People.

Step 3. Click Add Person button to bring up user creation dialog.

okta-1.png

Step 4. Fill out all the required fields and click Save.

You may choose to set a password now or send activation email: whatever works best for your organization. If you choose to set a password, make sure to save the username and password, as you will need to login with these credentials later.

okta-2.png

You should now be able to locate the newly created user in the People view.

okta-3.png

Section 2: Assign Read-Only Administrator role to the user account you just created

or another user account, which you intend to use for Fletch access

Please skip to the next section if you already have a user with Read-Only Administrator role.

Step 5. In your Okta Admin dashboard in the left pane access Security → Administrators.