Setting up who in your organization's security and operations teams (ie, which Admins) can view and edit configurations in the Banyan Command Center.
- Updated on Feb 08, 2022
- Account Types
- Administrator Profiles
- List of Admins
- Local Account Passwords and Lockout Threshold
- Deleting Admin Accounts and Decommisioning an Organization
- Personal Refresh Tokens
For security reasons, Banyan handles Admins and Users completely separately.
- Admins manage access control security policies via the Banyan Command Center Web Console and API.
- Users use their Devices to access Services that are secured by Banyan’s enforcement components. To manage users, refer to the articles on configuring IDPs.
Banyan categorizes administrative accounts by their Account Type. Banyan provides two types of admin accounts:
The table below lists the possible permissions and attributes for Banyan account types.
|Available if Local Admin is enabled|
|Available if SAML Single Sign On is enabled|
|Created via Banyan Command Center (Settings > Manage Admins)|
|Created just-in-time once authenticated with SAML Single Sign On Provider|
|Can use local account password to log in to the Banyan Command Center|
|Can use SAML Single Sign On to log in to the Banyan Command Center|
|Can generate API Keys for API access|
|Can generate Personal Refresh Token for API access|
|Can create Local administrator accounts (if account has Admin or Owner profile)|
|Can delete administrator accounts (if account has Admin or Owner profile)|
Every administrator (Local or SAML-Only) is assigned a profile that is associated with a single privilege level. Banyan provides several profiles, listed here in order of privilege:
- Owner (every organization must have at least one Owner)
The table below lists the permissions associated with the admin privilege levels:
|Create/Update/Delete Non-Owner Admins|
|Manage Organization Settings|
|Manage Roles & Policies|
(Services, Policies, Events, Directory etc)
When a SAML-Only account is created just-in-time, it is assigned a ReadOnly profile by default. Any administrator with Admin privilege can change the account’s profile.
List of Admins
View the list of administrators who have access to your Organization in the Banyan Command Center by navigating to Settings > Manage Admins.
Admins with SAML-only accounts will not show up in the Manage Admins users list until they have logged into the Banyan Command Center for the first time.
Local Account Passwords and Lockout Threshold
Local admins can use a local account password to log into the Banyan Command Center (unlike SAML-Only administrators, who must authenticate via their SSO Provider).
Banyan’s password policy requires all local accounts to have complex passwords that meet the following requirements:
- 8 or more characters;
- contains at least 1 uppercase letter;
- contains at least 1 lowercase letter;
- contains at least 1 digit; and
- contains at least 1 symbol
Local admin accounts are also configured with a lockout threshold (based on failed log-ons and password resets) to ensure that brute force attacks cannot compromise the account. Finally, a robust audit mechanism alerts the Banyan operations team when a series of failed log-ons or password resets occur in a given environment.
For more customizable admin authentication and alerting policies, you should enable SAML Single Sign On.
Deleting Admin Accounts and Decommisioning an Organization
In order to delete admin accounts, you need to be an administrator with an Admin profile. In order to delete a SAML-Only admin, you must first remove them from your SAML Single Sign On Provider, and then you can delete them in Banyan. Note that the default admin account is given a ReadOnly profile and cannot delete other admin accounts.
An organization must have at least 1 administrator with the Owner profile at all times; thus, you cannot delete every single admin account associated with an organization. Only the Banyan Operations Team can delete the final administrator account with Owner profile and completely decommision an organization. Contact Banyan Support if you need to do this.
Personal Refresh Tokens
Local Admins can generate Personal Refresh Tokens for automation workflows. To generate a personal Refresh Token, navigate to the My Profile page, and then click Generate Token.
The Refresh Token gives you full API access to your account - please store these tokens securely and do not provide them to a third party. The Command Center provides one Refresh Token per user account - it never expires but you can revoke the Refresh Token at any time.
Access Tokens to interact with the Banyan API can be obtained by submitting your Refresh Token.
To revoke a Refresh Token, navigate to the My Profile page, and then click Revoke Token.