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

To provide External Authentication, you must create and properly configure an Identity Provider.

Create an Identity Provider

  1. Go to Administration > Identity Providers.
  2. Create a New Record.
  3. Enter a Display Name (this can be anything).
  4. Select a Provider Type.
    1. If it's listed, use your specific provider.
    2. If it's not listed, use OAuth 2.0 as your provider.
  5. Enter a temporary Client ID.
    Note: You can't save the record without the temporary Client ID, but you will change it later.
  6. Click Save.
  7. Copy the Identity Provide Unique ID. You need this in a later step. You need to 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.

Developer Sites

Important: We no longer support external authentication with X (Twitter) or LinkedIn. If these were configured in the past, they might still work. However, adding or updating configuration for these may no longer work.

C. Recycle App Pool

You'll need to recycle the app pool on your server immediately after enabling 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. Clicking that button will make the external authentication option available.

System Information

You may need to provide the following values if required by 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

This Callback URL is created by taking the GUID from the Identity Provider and adding it to the base Callback URL.

The [IdentityProviderUniqueID] must be replaced with the ALL UPPERCASE GUID from your Identity Provider record.

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

MinistryPlatform
portal

Last updated: May 7, 2024