LumApps
  • 02 Sep 2024
  • 1 Minute to read
  • Contributors
  • Dark
    Light

LumApps

  • Dark
    Light

Article summary

Connection

Dedicated OAuth App

LumApps supports an extension for OAuth authentication through the API with client credentials flow.

Creating an OAuth App

LumApps allows an OAuth client credentials flow to interact with its API. To configure an OAuth app, you will need admin access to your instance settings page. You will need to share with your Unleash Representative the following information.

  • Application ID

  • Application Secret

  • Customer ID

  • Site Url (Haussman Cell)

  • Email of an admin user

  1. On the settings page, under the extensions section, click on Installed Extensions.

  1. Search for the OAuth application manager and ensure it is activated.

    1. If the OAuth application manager extension is not installed, install it from the Extension Library.

  1. From the Settings tab of the extension, click on Add a new OAuth Application.

  1. Name the application Unleash.

    1. You can choose if you want to impersonate a specific user or impersonate any user.

  1. Save and copy the new Application ID and Application Secret.

  1. Grab additional instance details by pressing CTRL+? or CTRL+SHIFT+?.

    1. The shortcut will open a Debug Info window.

    2. Copy the Customer ID and Haussman Cell.

Domain Delegation

As documented here, the LumApps connection supports an OAuth2 service account delegation flow. Unleash has created a service account that needs to be shared with the LumApps team. Contact the LumApps team at support@lumapps.com and provide them with access to the Unleash service account - 780897467552-pkmkek4fecblgj2j24cbr97q27q856dp.apps.googleusercontent.com.

LumApps does not have a self-serve connection screen. If you wish to connect it, please contact your Unleash representative for assistance.

You will need to prepare the following:

  • Site URL - Your LumApps instance URL.

  • Customer ID.

  • Email - An email of the user on whose behalf you want to act.

    • The email affects which resources will be synced to Unleash based on that user's permissions.

Supported Resources

The integration currently supports the following resources:

  • Pages

  • Posts

Sync

The integration does not support incremental updates, and therefore sync is scheduled every 24 hours.

API Calls

The table below outlines the primary endpoints utilized by the integration:

Endpoint

Docs

Purpose

/api/lumsites/v1/instance/list

https://neptune-dot-lumapps-api.appspot.com/docs/instance/list

List all available instances for customer

/api/lumsites/v1/community/post/list

https://neptune-dot-lumapps-api.appspot.com/docs/community/post/list

List all posts

/api/lumsites/v1/content/lis

https://neptune-dot-lumapps-api.appspot.com/docs/content/list

List all pages

/api/lumsites/v1/user/directory/get

https://neptune-dot-lumapps-api.appspot.com/docs/user/directory/get

Fetch user information


Was this article helpful?

What's Next