Site Admins

Manage the team of site administrators for the platform.

Table of Contents

What are the components of the Site Administration section?

The Administration quick filter launches the Administration section. Authorized site administrators can send out invitations to others whom they would like to invite to be site admins. All site admins have the same administration privileges for the platform deployment and can configure authentication domains that can be customized and assigned to APIs that are part of the platform deployment.

Invite Administrators

The Invite More function allows you to send invitations to individuals that you would like grant administration privileges for your API.

  • Existing administrators are displayed in a summary listing.
  • When an invitation is sent a request email is issued.
  • The invitee receives an invitation request on their Action Dashboard. If the invitee is not a platform member, they must sign up using the same email address that the invitation is addressed to in order to accept the invitation via their Action Dashboard.
  • While an invitation is still pending, a Resend Email button is available so you can remind the invitee.
  • At any point after a member has been invited, a Remove button is available so that you can remove the invitee or team member.

View Administrators

When an administrator invitation is submitted, a new entry is added to the list with the username, email address, and an initial invitation status of Pending.

Manage Administrators

A Site Administrator can remove another Site Administrator.

How do I invite someone to be a Site Administrator?

The platform includes an administrator invitation function that allows you to send out invitations to individuals to whom you would like to grant administration privileges for the current platform deployment.

  • During the platform installation, an initial site administration account is defined.
  • This initial administrator privilege is automatically approved and is displayed on the More > Admin >Site Admins page.
  • You can invite additional administrators using the Invite More function.

To invite someone to be a site admin

  1. Log in as a Site Admin and go to the Admin section.
  2. From the left menu, choose Site Admins. The Site Admins list is displayed.
  3. Click Invite More. The Invite Administrators page displays.
  4. In the Email text box, enter the email address of individuals you would like to invite to your development team. Separate each email address with a comma.
  5. In the Add a Brief Message text box, specify the invitation text you would like to send to your invitees.
  6. Click Invite. The invitation email is sent to the invitee.

After the email invitation is sent, the platform posts an invitation notification to the member's Action Dashboard. To become a Site Admin, the invited user must accept the invitation on the Action Dashboard.

How do I invite non-members to be Site Administrators?

If you have already received a Site Administrator invitation and are not currently a platform member, you must sign up to the platform using the email address that the invitation was issued to in order to accept the invitation. For more information, see Sign Up.

How do I cancel a Site Administrator invitation?

Once an invitation is sent to an individual you would like to be a Site Administrator, the invitation itself cannot be revoked. A platform member can choose to accept or decline the invitation. If they choose to accept the invitation, you can remove the Site Administrator from the Site Admins page by clicking Remove. See How do I remove a Site Administrator who is assigned to the platform deployment?

How do I respond to a Site Administrator invitation?

If you receive an invitation via email to be a Site Administrator for the platform, you can accept or reject the invitation.

For instructions, see How do I respond to an invitation on my Action Dashboard?

Note: When you first accept the invitation, you might need to refresh the page to see the Admin menu.

How do I assign users and groups to a Site Administrator?

Valid in Version: 2022.1.3 and later

The More > Admin > Site Admins > Add Users/Groups page allows you to search and assign users and groups to the Site Administrator role.

To assign users and groups

  1. Log in as a Site Admin and go to the Admin section.
  2. In the left menu bar, click Site Admins. The Site Administrator list is displayed.
  3. Click Add Users/Groups. The Add Users/Groups page displays.
  4. Use the dropdown menu to select the domain, user, or group to assign to a role. In the text box, type the name of the user or group to search in the selected domain, and click Go. The name of the users or groups will be displayed in the Results list.
  5. Click to select the checkbox for the user or group name from the Results list to assign them a site admin role. Click Assign.
  6. The user or group name appears in the Selected Users/Groups list. Click Save.
  7. To remove a user or group, click to select the checkbox for the user or group name from the Selected Users/Groups list. Click Remove.

How do I assign LDAP domain users and groups to a Site Administrator?

Valid in Version: 2022.1.3 and later

To assign the external LDAP domain users and groups to a Site Administrator role, follow the instructions:

Prerequisites

Before you begin:

  1. Configure an LDAP Directory or Active Directory Identity System. See, Configure Directory Server (Active Directory) Identity System.

  2. Enable a domain login for users to log in to the platform. See, How do I enable a domain for login?

Configuration on Community Manager

To assign the users and groups

  1. Log in to the Community Manager developer portal.
  2. Go to the More tab, click Admin, and then click Site Admins.
  3. Click Add Users/Groups. The Add Users/Groups page displays.
  4. Use the dropdown menu to select LDAP domain and User or Group to assign them to a role. To assign:

    • User: Search for users in the selected domain and assign them to the Site Admin role. Click Go.

    • Group: Search for groups in the selected domain and assign them to the Site Admin role. Click Go.

  1. Click to select the checkbox for the user or group name from the Results list to assign them a site admin role. Click Assign.
  2. The user or group name appears in the Selected Users/Groups list. Click Save.

How do I assign SAML Web SSO domain users and groups to a Site Administrator?

Valid in Version: 2022.1.3 and later

You can configure an attribute that contains all of the groups to obtain access permission. The following example shows string from the SAML assertion, the SAML attribute name is AkanaGroupMembership and SAML attribute value is akana-siteadministrators.

<saml:Attribute Name"AkanaGroupMembership" NameFormat"urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
 <saml:AttributeValue xmlns:xs="http://www.w3.org/2001/XML_Schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xs:string">akana-siteadministrators</saml:AttributeValue>

To assign the external SAML Web SSO domain users and groups to a Site Administrator role, follow the instructions:

Prerequisites

Before you begin:

  1. Configure the SAML Web SSO domain. See, Setting Up the SAML Web Browser SSO.

  2. Configure the Identity Provider to send additional attributes for Group Memberships. The attribute mapping for groups must be done in Policy Manager to match the "Group Memberships" attribute name, which will be sent in the SAML Assertion response. See, Configure the SSO domain in Policy Manager.

  3. Enable a domain login for users to log in to the platform. See, How do I enable a domain for login?

Configuration on Community Manager

To assign the users and groups

  1. Log in to the Community Manager developer portal.
  2. Go to the More tab, click Admin, and then click Site Admins.
  3. Click Add Users/Groups. The Add Users/Groups page displays.
  4. Use the dropdown menu to select the SAML domain and User or Group to assign them to a role. To assign:
    • User: Search for users that have previously logged into Akana via the selected domain and assign them to the Site Admin role.

    • Group: Provide the exact value of the group attribute in the SAML assertion for a user that is mapped to the Site Admin role.

  1. Click to select the checkbox for the users from the Results list to assign them a site admin role. Click Assign.
  2. The user or group name appears in the Selected Users/Groups list. Click Save.

How do I remove a Site Administrator who is assigned to the platform deployment?

Any Site Administrator can remove other administrators from the platform deployment.

To remove someone from the Site Admin team

  1. Log in as a Site Admin and go to the Admin section.
  2. From the left menu, choose Site Admins. The Site Admins list is displayed.
  3. On the list, find the Site Administrator that you want to remove and click Remove.