pomerium/docs/docs/identity-providers
Caleb Doxsey 07e150a5af
ping: add documentation (#1976)
* ping: add documentation

* Update docs/docs/identity-providers/ping.md

Co-authored-by: bobby <1544881+desimone@users.noreply.github.com>

* Update docs/docs/identity-providers/ping.md

Co-authored-by: bobby <1544881+desimone@users.noreply.github.com>

* use yaml for config

Co-authored-by: bobby <1544881+desimone@users.noreply.github.com>
2021-03-12 09:03:56 -07:00
..
img ping: add documentation (#1976) 2021-03-12 09:03:56 -07:00
auth0.md update the documentation for auth0 to include group/role information (#1502) 2020-10-09 13:42:25 -06:00
azure.md update azure docs (#1723) 2020-12-29 13:20:03 -07:00
cognito.md update docs (#1645) 2020-12-03 08:29:17 -08:00
github.md authenticate: update user info screens (#1774) 2021-01-13 13:15:31 -08:00
gitlab.md Update GitLab provider docs (#1591) 2021-02-01 15:48:06 -08:00
google.md update google docs (#1738) 2021-01-07 10:17:16 -07:00
okta.md docs/docs: fix wrong okta service account field (#1251) 2020-08-11 09:05:36 +07:00
one-login.md
ping.md ping: add documentation (#1976) 2021-03-12 09:03:56 -07:00
readme.md

title description
Overview This article describes how to connect Pomerium to third-party identity providers / single-sign-on services. You will need to generate keys, copy these into your Pomerium settings, and enable the connection.

Identity Provider Configuration

This article describes how to configure Pomerium to use a third-party identity service for single-sign-on.

There are a few configuration steps required for identity provider integration. Most providers support OpenID Connect which provides a standardized identity and authentication interface.

In this guide we'll cover how to do the following for each identity provider:

  1. Set a Redirect URL pointing back to Pomerium. For example, https://${authenticate_service_url}/oauth2/callback.
  2. Generate a Client ID and Client Secret.
  3. Generate a Service Account for additional IdP Data.
  4. Configure Pomerium to use the Client ID and Client Secret keys.
  5. Configure Pomerium to synchronize directory data from your identity provider (e.g. groups membership), by setting a service account.

:::warning

You must configure an IdP Service Account to write policy against group membership, or any other data that does not uniquely identify an end-user.