Managing Access Options

The OAuth protocol requires that the client application provide users with a BarTender Cloud sign-in form, and it grants access to only the specific client that the user is signed in to. Seagull recommends that you use the OAuth protocol for web-based applications.

• To start the registration process for OAuth access, in the Web Applications (OAuth) section, click Register Application for OAuth Access.

This type of access is required when your application cannot provide users with a BarTender Cloud sign-in form, which is typical for console applications and services that do not have a GUI.

• To start the registration process for password-based access, in the Console Applications and Services (Password-Based) section, click Register Application for Password-Based Access.

Use the BarTender Cloud API page to create and manage machine-to-machine (M2M) applications.

This type of access is required when you use third-party integrations, such as BarTender Print Connector for Dynamics 365 Business Central. Register a machine-to-machine application to enable secure integration access.

1. In the Machine-to-Machine (Client Credentials) section, click Register M2M Application.

2. In the Create M2M Application dialog, enter the following information:

   • Application Name: Enter a name for the application. This name must be unique within your organization. Required.

   • Description (optional): Enter a description of the application.

   • Service Account: Select the service account from which this application will inherit permissions. Required.

     Create Service Account: If you need to create a service account, click this link to open the Service Accounts page.

   • Token Lifetime: Select the length of time the token is valid. Required.

   • Status: Select Active or Disabled.

3. Click Create Application.

4. Copy the ID and Secret and store those values.

1. In the row for the application you want to edit, click and select Edit.

2. Modify the following information as needed.

   In the Edit Web Application Registration dialog:

   • Name

   • Description

   • Login URI

   • Callback List

   • Logout URLs

   • Allowed Origins (CORS)

   • Allowed Web Origins

   In the Edit Password-Based Access dialog:

   • Name

   • Description

   In the Edit M2M Application dialog:

   • Application Name

   • Description

   • Service Account

   • Token Lifetime

3. Click Save.

1. In the row for the application you want to delete, click and select Delete.

2. In the Delete Application Registration dialog, click Delete Registration.

1. In the row for the application you want to work with, click and select View ID & Secret.

2. To copy the ID or Secret, click .

3. To rotate the ID or Secret, click Rotate ID & Secret.

4. To close the dialog, click Close.

• In the row for the application you want to view, click and select View Client ID.

  In the Client ID dialog you can click to copy the client ID if necessary.

1. In the row for the application you want to view, click and select Regenerate Client Secret.

2. Click Regenerate to acknowledge that you want to regenerate the Client Secret.

3. In the M2M (Client Credentials) dialog, click to copy the ID and Secret, separately, and store those values.

4. Click Close.

Disabling an application prevents it from making BarTender API calls. It must be re-enabled before the application can make those calls again.

Disabling an application

1. In the row for the application you want to disable, click and select Disable.

2. In the Disable M2M Application dialog, click Disable.

   The application is disabled and (Disabled) is appended to the application's name.

Enabling an application

• In the row for the application you want to enable, click and select Enable.

1. In the row for the application you want to delete, click and select Delete.

2. In the Delete M2M Application dialog, click Delete Application.

1. In the Test Credentials section, click View Access Token.

   The Personal Access Token dialog opens.

2. To copy the access token to your clipboard, click Copy Access Token.

3. To obtain a new access token, click Refresh Access Token.

   An access token is required to connect to the BarTender Cloud REST API. Once you obtain an access token by registering your application, BarTender Cloud automatically renews the token when it expires.

4. To close the dialog, click Close.