Requirements:
- To use the farmerswife (fw) Server-side "OpenID Connect" integration does not need to be licensed.
- In order for the "OpenID Connect" integration to work with "Okta Single Sign On", your farmerswife system needs to be running on v6.8 Service Pack 1 (released 24th of August 2022).
Creating the App Integration in Okta:
Go to https://www.okta.com/topic/single-sign-on/ and register a new "Free Trial" account, if you're evaluating this.
Or, use your Companies access credentials to Login into https://www.okta.com .
When logged into Okta enter the Admin console.
On the left menu select the Applications tag under Applications.
When creating the application in Okta, select the Authorization Code check-box as the Grant type. Then you will be given the option to set Sign-in/Sign-out URIs. These URIs will be the resources you want your users to see when they are signing in and out of farmerswife through Okta. Multiple URIs can be used to use different "landings" for different types users according to your needs.
If you are using "Access Groups" in Okta, you will also be able to set who will have access to the new application integration you are creating on the Okta "My Web App" page.
When Limit access to selected groups is selected, it will prompt to select which "Groups" will be able to use this integration.
Configuring the farmerswife Server:
Go to your running fw Server app > Setup > General > Users tab > "OpenID Connect" section.
Most information in this section will be provided by Okta when a new application integration is created.
Getting the needed info from Okta:
When logged into Okta enter the Admin console.
On the left menu select the Applications tag under Applications. Select the application that was created for the farmerswife Integration. On the General tab you will find the Client ID and Secret Key.
For the Authorize, Token and Userinfo endpoint information it will usually be a URL that is associated to your company's name (as seen in the example above).
Please also see and use the Okta endpoint documentation:
https://developer.okta.com/docs/reference/api/oidc/
Conclusion:
These are the main steps needed to create the farmerswife/Okta integration.
Once this is completed on Okta, the application can be added to the "My Apps" section for users who have authorization and they will be able to launch the application from their dashboard.
Remember, in order to use this integration the properly configured fw server app must be running, to be able to handle requests for logins from Okta.