Skip to main content

Authorization

Follow this guide to create a new Manhattan credential that will allow Nexla to authenticate to and exchange data with your Manhattan Active account.
manhattan_api_auth.png

Manhattan

Prerequisites​

Before creating a Manhattan credential, you'll need to obtain OAuth 2.0 credentials (Client ID and Client Secret) from your Manhattan Active account. Manhattan Active uses OAuth 2.0 client credentials flow (2-legged OAuth) for API authentication.

To obtain Manhattan Active API credentials:

  1. Log in to your Manhattan Active account. The URL format depends on your deployment: https://<unique_id>.omni.manh.com, https://<unique_id>.sce.manh.com, or https://<unique_id>.scp.manh.com.

  2. Navigate to the API or Developer settings section in your Manhattan Active account. This is typically found in the system administration or integration settings.

  3. In the API settings, locate the OAuth client management section. Manhattan Active uses OAuth 2.0 clients for API access.

  4. Create a new OAuth client or select an existing one. You'll need to provide a name and description for the client.

  5. After creating the OAuth client, you'll receive a Client ID and Client Secret. Copy these credentials immediately, as the Client Secret may only be displayed once.

  6. Note your Manhattan Active API URL and Authorization Server URL. These URLs follow the pattern:

    • API URL: https://<unique_id>.omni.manh.com, https://<unique_id>.sce.manh.com, or https://<unique_id>.scp.manh.com
    • Authorization Server URL: https://<unique_id>-auth.omni.manh.com, https://<unique_id>-auth.sce.manh.com, or https://<unique_id>-auth.scp.manh.com

Manhattan Active uses OAuth 2.0 client credentials flow (2-legged OAuth), which means you don't need user authorization. The Client ID and Client Secret are used to obtain an access token directly. The unique ID in your URLs is specific to your Manhattan Active deployment.

For detailed information about Manhattan Active API authentication and OAuth client management, refer to the Manhattan Active Developer Documentation.

Create a Manhattan Credential​

  • To create a new Manhattan credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Manhattan

ManhattanCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Credential Settings​

  1. In the Client ID field, enter the Client ID that you obtained from your Manhattan Active OAuth client settings.

  2. In the Client Secret field, enter the Client Secret that you obtained from your Manhattan Active OAuth client settings.

    The Client Secret is sensitive information and should be kept secure. If you've lost your Client Secret, you'll need to generate a new one in your Manhattan Active OAuth client settings.

  3. In the Authorization Server URL field, enter the endpoint to obtain access token. This should be in the format https://<unique_id>-auth.omni.manh.com, https://<unique_id>-auth.sce.manh.com, or https://<unique_id>-auth.scp.manh.com, where <unique_id> is your Manhattan Active deployment identifier. The default value is https://<unique_id>-auth.scp.manh.com.

  4. In the Manhattan Active API URL field, enter the application URL for your Manhattan Active deployment. This should be in the format https://<unique_id>.omni.manh.com, https://<unique_id>.sce.manh.com, or https://<unique_id>.scp.manh.com, where <unique_id> is your Manhattan Active deployment identifier. The default value is https://<unique_id>.scp.manh.com.

  5. Optionally, in the Email used only for validation field, enter an email address that will be used for connection validation. The default value is anyuser@example.com. This email is only used to test the connection and does not need to be a real user email.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.