Tenant authorization
The Tenant Manager makes it easier to oversee and update authorization records related to employees and tenants. The information is organized per environment. We do not yet show you if they are actively using the app.
Who has authorized this app?
The app page shows how many tenants that have authorized one specific application in each environment.
In the Developer Portal, go to your app page.
To see the list of all apps:
- Select Apps from the top menu to see all apps across every partner you have access to, or
- Go to the Applications section of your partner page to see that partner's apps.
Select Overview and locate the Tenants section. The table shows the number of tenants per environment.
Click one of the environments (SOD, Stage, Production) to open the Tenant listing page. This page will show detailed tenant names and IDs for each environment. To know who authorized the app and when the authorization is valid, you need to select a specific tenant to open the Tenant details page.
Note
The tenants listed are filtered to show only those associated with the specific application if you accessed the tenant overview from the app page.
Optional, switch environments to explore further.
Authorization status
Each authorization on the Tenant details page has a Status that tells you whether the app can still access that tenant:
| Status | Meaning |
|---|---|
| Active | The authorization is in place and the app can access the tenant. |
| Expired | The authorization's validity period has ended — the To date has passed. The app can no longer access the tenant until the authorization is renewed. |
| Revoked | The authorization has been revoked. The connection between the app and the tenant's database is severed and the app can no longer access it. Data in the database is not removed. Contact us if you are unsure why the authorization was revoked. |
To review authorization status for a tenant:
On the Tenant listing page, open a tenant to see its Tenant details page.
Select the Authorizations tab.
Check the Status column. Each authorization is Active, Expired, or Revoked. Use the Status filter above the column to show only one status.
See authorization status on the Tenant listing
You don't have to open each tenant to find revoked or expired authorizations. The Tenant listing has an Authorizations column that summarizes how many of a tenant's app authorizations are active, expired, and revoked, so you can spot affected customers across all your apps at a glance.
Open a tenant and go to the Authorizations tab to see the status of each individual authorization.
Request authorization
Apps require customer consent to access customer data.
Navigate to your partner page in the Developer Portal and select Tenants.
On the Tenant listing page, go to the Production tab and click Request Authorization.
Select an application from the list.
Enter customer name and Cust ID in production.
Provide the email address of the customer's contact person.
Optionally, add additional info.
Click Send. An email will be sent to the customer for confirmation. Access is granted upon approval.
Edit tenant authorization
Go to the Tenant listing page.
Select an environment tab (SOD, Stage, Production) and choose the tenant you wish to update.
On the Tenant details page, open the Authorizations tab.
Locate the application in the list and click Edit.
Enter who you submit this request on behalf of.
Complete the form and click Send.
Remove tenant authorization
Revoking access severs the connection between the application and the tenant's database but does not remove data from the database.
On the Tenant details page, go to the Authorizations tab.
Locate the application in the list and click Remove.
Enter the customer contact's email address.
Provide a reason for removing the authorization.
Click Send.
