+
+---
+
+### Okta
+
+1. Login to Okta and, once logged in, Note the current URL. This is used for the 'BASE_URL' in step 6.
+2. Navigate to the Admin panel then 'Applications' then select 'Add Application'. Then select 'Create New App' on the left.
+3. For the 'Platform' choose 'Web'. For the 'Sign on method' choose 'OpenID Connect' then click 'Create'.
+4. Give the app a name such as 'BookStack' or 'Our documentation'. Under the 'Login redirect URIs' option add both of the below URLs, Changing `https://example.com` to the base URL of your BookStack instance:
+ - `https://example.com/login/service/okta/callback`
+ - `https://example.com/register/service/okta/callback`
+5. Save and scroll down to the 'Client Credentials' area. Copy the 'Client ID' and 'Client secret' values. These are your 'APP_ID' and 'APP_SECRET' values for step 6.
+6. Copy these details and add them as new variables in your `.env` file like so:
+ ```bash
+ # Replace the below (including '{}' braces) with your okta APP_ID and APP_SECRET and BASE_URL.
+ OKTA_APP_ID={APP_ID}
+ OKTA_APP_SECRET={APP_SECRET}
+ # The base URL is the URL from step 1 but with everything after the domain (okta.com) removed.
+ OKTA_BASE_URL={BASE_URL}
+
+ # APP_URL Needs to be set to your BookStack base url
+ APP_URL=http://mybookstackurl.com
+ ```
+7. All set up! Remember to assign the new application you created in Okta to your Okta users otherwise they will not be able to register/login using the service.
\ No newline at end of file
projects / website / commitdiff