CONNECTORS.md

Connectors

Authenticators

An authenticator allows you to authenticate the user using third party authentication systems such as LinkedIn, Duo security and Foursquare.

By default Identity Server packs several of these Authenticators and they are available to be configured via the Console.

But WSO2 has a wide range of authenticators in the connector store that you can plugin in to your Identity Server instance.

Let's see how we can configure LinkedIn connector in Console.

Steps

1. Download the LinkedIn connector from WSO2 connector store.(org.wso2.carbon.extension.identity.authenticator.linkedin.connector-x.x.x).

2. Place the authenticator.jar file into the <IS_HOME>/repository/components/dropins directory.

3. Re-start the WSO2 Identity Server.

💡 For more in formation, read through the connector documentation.

4. Login to Console (https://localhost:9443/console)

5. Navigate to Connections > Create Connection and create a Connection with the Custom Connector Connection template.

   

6. Once the Connection is created, navigate to the Settings tab and click on New Authenticator button.

7. Select LinkedIn from the authenticator selection and proceed with configuration.

   

(🦄 Optional) Add connector metadata to supplement the UI

Optionally, you can add a display name, icon and a description to the newly added connector to make the UI nicer 😉.

Add something like the following in the <IS_HOME>/repository/conf/deployment.toml.

💡 UI maps the meta data with the authenticatorId. This can be found by checking the Browser Network tab when the authenticators are loaded in the Settings tab.

[[console.extensions.connectors]]
authenticatorId="TGlua2VkSW4"
description="Login users with existing LinkedIn accounts"
displayName="LinkedIn"
icon="https://brand.linkedin.com/content/dam/me/business/en-us/amp/brand-site/v2/bg/LI-Bug.svg.original.svg"