Below you will find instructions for setting up your Okta account with Ploy. In order to maintain a least privileged level of access, we’ve opted to use an API integration application, rather then an admin API token.

1. Navigate to Ploy

  1. Go to Ploy's integration page: https://app.joinploy.com/integrations
  2. Click Okta
  3. Enter in your Okta Domain a. Please note this should be the sub-domain from the Okta login e.g. company.okta.com

https://downloads.intercomcdn.com/i/o/907502043/c80d1f4d4d6dab295e6f9b01/Screenshot+2023-12-12+at+15.34.05.png?expires=1734258600&signature=96c95f1be07d0c185dcf4f8d0e17bccc35eb66f85122772a8397c61b550d1fb7&req=fSAgE8l8nYVcFb4f3HP0gEjCI1d1FFF846DS1HCHMj9LoSBx2F5Pz5pVwRXm
UdcMsyEy78Wx%2F86aVw%3D%3D

2. Go to your Okta account

  1. Select Applications on the left hand nav bar
  2. Click Create App Integration
  3. Select API Services and click Next

https://downloads.intercomcdn.com/i/o/907474785/2a110ca416dc7b74453b9e2d/Screenshot+2023-04-18+at+11.19.35.png?expires=1734258600&signature=46bd7d6c35eac47210cedbfff006ab4ed9d7204579ce400f8c8bd743c5fe4faa&req=fSAgEs56molaFb4f3HP0gEXPD0QcS56mVrZHW3TRfwys66mKdGZTKR0lfiB8
k85SNc9DoLBlY9zMbA%3D%3D

https://downloads.intercomcdn.com/i/o/907475369/6d2c8fbab69b65efb3e99cd6/Screenshot+2023-04-18+at+11.19.40.png?expires=1734258600&signature=c9a312082999e29466c29f62cd0287284e95bff33052aa74460dc0e33e5cdbb8&req=fSAgEs57nodWFb4f3HP0gAYvaSDjjZF2pG8XOFfEs5%2FA5wHmK9H9wHmuIGiW
%2Biceixv7QeJVHC9vkQ%3D%3D

3. Name the Application (e.g. Ploy Okta Integration)

Enter Ploy or anything else that will help make it easily recognisable and press next.

4. Select "Edit" so you can start configuring the app

https://downloads.intercomcdn.com/i/o/907476366/71b2ad224594966924bb31ca/Screenshot+2023-04-18+at+10.11.39.png?expires=1734258600&signature=614d13f6074ad045c33a922491ce21971395d4902202a78b586ec91c2a6c03d6&req=fSAgEs54nodZFb4f3HP0gII3bWgIjpbrOb6OmS2JCs9cW3oLdd%2BXwPbFsHYN
693AE73NGHdPxE4E3Q%3D%3D

5. Configure "Client authentication"

  1. Click the radio select Public key / Private Key
  2. Select the "Add Key" button

https://downloads.intercomcdn.com/i/o/907476929/7b0248bba2f7bd9aab7a7851/Screenshot+2023-04-18+at+10.11.47.png?expires=1734258600&signature=aa3967ed929b823f1dd8b99f09bb3cef6ebfeba636b231bb03f1e7d42c228500&req=fSAgEs54lINWFb4f3HP0gE0k2hA%2BNemAESLy93kDMjtIZKy%2FHj1k4PhA9eNU
mffoj0zX7dhvyVJcwg%3D%3D

6. Generate a new key

Click the Generate new key button in the top right of the pop-up window

https://downloads.intercomcdn.com/i/o/907477199/e66f224d6e89354232fa0c17/Screenshot+2023-04-18+at+10.11.51.png?expires=1734258600&signature=c6aca3501465889921de9f58639406a402db6b056c90f42eb7c7716ea2197e90&req=fSAgEs55nIhWFb4f3HP0gO4CLCaPbTys1RCKvI0Uc9RQl%2FzO5rk1oKO1OlLK
pi3BneiqRRCBauZNGQ%3D%3D

7. Copy Private key

Please do not click the Generate new key button.