Manage users and edges - Admin Console#
Admin Console v1.5.0
Important
Admin Console is only available to users with the admin role in the global context.
Display a list of users (For administrators)#
Open the Admin Console (<base_URL>/admin/
).
Note
Admin Console does not appear in the application list, so use the URL to access it.
The list of users is displayed.
Search by name (partial match)
Filter by activation status, lock status, password status
Hint
When you change the sort order, perform a string search, or specify a filter, the URL of the current list is displayed in the address bar. By bookmarking this URL, you can later view the list with the same criteria.
Create a user account (For administrators)#
Administrators can create user accounts in the Admin Console.
Open the user list (
<base_URL>/admin/users
) in the Admin Console.Click [Create User].
Set the name and roles.
The name can contain alphanumeric characters (0-9, A-Z, a-z), hyphens (-), and underscores (_).
You cannot use a user name that is already in use in the intdash domain.
Set roles such as admin, member, etc. The roles set here are those in the global context. Available roles depend on the intdash domain.
Multiple roles can be set for a single user account.
Roles set when the user account is created cannot be changed in the Admin Console.
Other settings are optional.
Click [Create].
When the temporary password is displayed, click [Copy] to copy it to the clipboard.
Attention
The temporary password has an expiration date. Please keep in mind the expiration date indicated.
Inform the user of the sign-in URL, username, and temporary password in a secure manner. The user will be prompted to set a new password the first time they sign in.
Edit a user (For administrators)#
Note
See Configure your account - My Page for how general users can see their information.
Click [Details] of the user you want to see. The following information is displayed.
- Password
The password status for this user account is displayed. There are 2 types of status as below.
Status
Description
Temporary
The administrator has created a temporary password. Waiting for the user to set a new password on My Page.
Not Temporary
A password has been set by the user.
If you want to reissue a password, see Reissue a password (For administrators).
- UUID
A user-specific ID automatically assigned by intdash. The UUID cannot be changed.
- Name
The name of the user. You cannot use a user name that is already in use in the intdash domain.
- Nickname (optional)
You can give the user a descriptive nickname.
- Description (optional)
You can enter a description of the user.
- Enabled
You can enable or disable this user. If disabled, this user will not be able to sign in.
Even if a user account is disabled, the edge accounts owned by that user can still be used. To disable an edge account, delete that edge account.
- Created At
The date and time when this user was created.
- Updated At
The date and time when this user was updated.
- Emails
The email addresses registered for this user account and the registration statuses. There are three types of status as follows.
Status
Description
Unregistered
The email address is not registered. Users can sign in using the user name and password even if their email address is not registered.
Not Verified
The email address is registered but not verified. To verify the email address, the user needs to send a confirmation email to themselves by clicking a button on My Page.
Verified
The e-mail address has been registered and verified.
- Roles
The role of this user in the global context. The types of roles vary by domain.
Attention
Roles set when the user account is created cannot be changed in the Admin Console.
- API tokens
Displays API tokens issued for this user account. See Create API tokens (For administrators) for issuing API tokens.
If you want to change the settings, edit them and click [Save changes].
Delete a user (For administrators)#
Open the user list (
<base_URL>/admin/users
) in the Admin Console.Click [Details] for the user.
Click [Delete].
When a user account is deleted, the edge account owned by that user will have no owner. The administrator can set a new owner in the edge account details screen. See Edit an edge account (For administrators) for more information.
Hint
If you want to delete multiple user accounts at once, select the check box of the target users and click [Delete Selected] at the top of the screen.
Reissue a password (For administrators)#
Open the user list (
<base_URL>/admin/users
) in the Admin Console.Click [Details] for the user account for which you want to issue a password.
Click [Reset Password].
Click [Reset] to reset the password.
The current password will be invalidated and a temporary password will be created. You can copy it to the clipboard by clicking [Copy].
Notify the user of the temporary password in a secure manner.
When the user signs in, they will be prompted to set a new password for themselves.
Attention
The temporary password has an expiration date. Please keep in mind the expiration date indicated.
Unlock a password (For administrators)#
If a user tries to sign in to intdash and gets the password wrong a certain number of times (5 times in the default setting), the password is locked and the user cannot sign in. The administrator can unlock the password.
Open the user list (
<base_URL>/admin/users/
) in the Admin Console.Click [Details] for the user account you want to unlock the password for.
Click [Unlock].
Create API tokens (For administrators)#
Note
See Create an API token for information on how a general user can create their own API token.
If you want to access the intdash API as a user using a program with the intdash SDK, you will need an API token. Administrators can create API tokens.
Open the user list (
<base_URL>/admin/users/
) in the Admin Console.Click [Details] for the user account for which you want to create tokens.
Click [Create API Token].
Enter a name to distinguish the API tokens (setting the expiration date is optional).
Click [Create].
Click [Copy] to copy the API token and notify the user in a secure way.
Note
The API token is displayed only once at the time of creation.
The user account details screen will show the statuses of the API tokens that have been created.
There is a limit to the number of tokens per user. If "Available" is 0, tokens cannot be created.
Users can create their API tokens in My Page.
List of edges (For administrators)#
When you open the Admin Console, you will see a list of edges.
Search by name (partial match)
Filter (filtering is not possible in the current version)
Hint
When you change the sort order or perform a string search, the URL of the current list will be displayed in the address bar. By bookmarking this URL, you can later view the list with the same criteria.
Create an edge account (For administrators)#
Note
See Create edge accounts for how a general user can create their own edge account.
Administrators can create edge accounts in the Admin Console. When you create an edge account, you will be issued a UUID for that edge and a client secret for authentication.
Open the edge list (
<base_URL>/admin/edges
) in the Admin Console.Click [Create Edge].
Set a name.
The name can contain alphanumeric characters (0-9, A-Z, a-z), hyphens (-), and underscores (_).
You cannot use an edge name that is already in use in the intdash domain.
Other settings are optional.
Click [Create].
The UUID of the edge and the client secret will be displayed. Copy them.
Attention
The client secret is displayed only once.
Note
When you create an edge account in the Admin Console, the edge account has no owner. The owner can be set later. The name and display name can also be changed later. See Edit an edge account (For administrators) for more information.
Edit an edge account (For administrators)#
Note
See Change/delete an edge account for information on how general users can see information about their edges.
Click [Details] for the edge you want to see. The following information is displayed.
- UUID
An edge-specific ID automatically assigned by intdash. The UUID cannot be changed.
- Name
The name of the edge. You cannot use an edge name that is already in use in the intdash domain.
- Nickname (optional)
You can give the edge a descriptive nickname.
- Description (optional)
You can enter a description for the edge.
- Created At
The date and time when this edge was created.
- Updated At
The date and time when this edge was updated.
- Owned By
The owner of this edge. The owner can change the name and nickname of the edge in My Page.
If you want to change the settings, edit them and click [Save changes].
Note
If you click [x] to delete the owner and save the changes, the edge will have no owner.
Delete an edge account (For administrators)#
Note
See Change/delete an edge account for how general users can delete their edges.
Open the edge list (
<base_URL>/admin/edges
) in the Admin Console.Click [Details] for the edge.
Click [Delete].
Hint
If you want to delete multiple edge accounts at once, select the check box of the edge accounts and click [Delete Selected] at the top of the screen.
Create a top-level group (For administrators)#
Administrators can create top-level groups that are not subgroups of other groups.
Note
See Create a group for information on how a regular user can create groups.
Open the group list (
<base_URL>/admin/groups
) in the Admin Console.Click [Create Group].
Enter a group name and click [Create].