chocrates / okta-webhooks

Okta Webhook handler

This project utilizes expressjs to listen for a single okta request (group.user_membership.add) and add's a user to your github server when it is found

Setup

Setup involves a few pieces. Firstly you a machine somewhere to run this code. Second you need to set up Okta to send webhooks to that server.

Express Server

• Clone the repository
• Install the dependencies
  • npm install
• Copy .env.example to .env and fill out the information

Environment Variable	Description
PORT	Port to listen for events
PRIVATE_KEY_PATH	SSL Private Key path
CERTIFICATE_PATH	SSL Private Key Certificate Path
GROUP	Okta group on which we are adding users
BASE_URL	Base URL for your github instance in the form "https:///api/v3"
PAT	Personal Access Token of the user making requests to the GitHub API

• Finally run the server
  • node index.js
  • Note: Okta requires ssl enabled so you may have to setup your certificates first. See Let's Encrypt for a fast solution.

Okta Webhooks

• Open the Okta Event Webhooks page
• Add a new webhook
• Add the DNS entry to your webhook and select user added to group event to listen to
• Click Save and Continue
• Finally select Verify
  • This sends a verification event to the server and will immediately respond that the server is verified