Skip to content

Deploying scimify with SCIM 2.0 templates

Dragos Gaftoneanu edited this page Oct 25, 2019 · 6 revisions

Local configuration

  • Download scimify from GitHub and upload it in the public directory of your local web server (the path to the scimify should look in the end like /var/www/public_html/scimify)
  • Create a MySQL database and add the configuration details (database username, database password, database host and database name) under {path_to_scimify}/resources/config.php in the constant definitions
  • Start ngrok from command line (eg. ngrok http 80) and copy the https link under Forwarding link sections
  • Append to this URL the path to scimify and then /scim/v2 (for example https://abcdef.ngrok.io/scimify/scim/v2); this will be the value for Base URL in Okta

Configuration in Okta

  • In your Okta preview tenant, navigate to Admin and hover over Developer Console present in the top left corner of the page and select Classic UI; this will change the administrative interface used
  • Navigate to Applications >> Add Application and search for "SCIM 2.0 Test App" (any of the options available will work)
  • Name your application as preferred under Application label and then select Next
  • Select Done; the Sign On Methods present on this page and in the application are placeholders and do not require any configuration
  • Once redirected to the application, select Provisioning tab, click on Configure API Integration >> Enable API Integration and add the base URL copied earlier (eg. https://abcdef.ngrok.io/scimify/scim/v2) in SCIM 2.0 Base URL section; for credentials you can add any values as scimify will not check them
  • After the credentials are saved, the provisioning options will be enabled
  • Under Provisioning tab >> To App, click Edit and enable Create Users, Update User Attributes, Deactivate Users and, optionally Sync Password, saving the values at the end by pressing Save

Reviewing requests and response

  • When a provisioning event occurs from Okta to scimify, you will be able to see it in ngrok by navigating in the browser to ngrok's web interface available at http://127.0.0.1:4040
  • If you would like to learn more about using the web interface, check the article available here

Resetting the environment

  • If you would like to reset scimify to test new scenarios, simply drop the tables scimify creates (memberships, resources, resource_attributes and resource_schemas) and, at the first request, they will be automatically recreated