home

MinistryPlatform

RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite
RealmRealm AccountingMinistryPlatformeGivingPDSACSConnectShepherdGrowth MethodHeadMasterRefresh WebsitesTrust CenterGo MethodMissionInsite

What would you like to know more about?

Show Contents

Show Page Sections

thumbnailMinistryPlatform

External Login Authentication

Enable Identity Provider

This section examines how to create and configure an identity provider, including provider-specific values and system information.

To provide external authentication, you must create and properly configure an identity provider.

Create an Identity Provider

  1. In the navigation menu, click Administration > Identity Providers.
  2. Click New Identity Provider.
  3. Enter a display name.
  4. Select a provider type.
    • If it's listed, use your specific provider.
    • If it's not listed, use OAuth 2.0 as your provider.
  5. Enter a temporary Client ID.
    Note: You must enter a temporary Client ID in order to save the record, but you will change it later.
  6. Click Save.
  7. Copy the Identity Provide Unique ID. You need this in a later step. Replace any lowercase characters with uppercase.

Configure Provider-Specific Values

  1. Go to the developer site for the account.
  2. Provide your system information in the applications.
  3. Enter an App ID.
  4. Enter an App Secret.

Recycle App Pool

You must recycle the app pool on your server immediately after you enable the identity provider. If Setup Admin is set to Yes on your User record, you will have a Restart Auth App button on your User Profile. Click the Restart Auth App button to make the external authentication option available.

System Information

You may need to provide the following values if required by your identity provider.

MinistryPlatform Installation

This is the base URL for your MinistryPlatform installation ending in MinistryPlatform and (nothing else).

https://[YourDomain]/ministryplatform

External Login Callback URL

To create this Callback URL, take the GUID from the identity provider and add it to the base Callback URL.

You must replace the [IdentityProviderUniqueID] with the ALL UPPERCASE GUID from your identity provider record.

https://[YourDomain]/ministryplatformapi/oauth/callback/[IdentityProviderUniqueID]

MinistryPlatform

Last updated: September 19, 2024