Skip to content

Commit

Permalink
Fix Bot Users Page (#438)
Browse files Browse the repository at this point in the history
Found a bunch of typos and grammar issues. Added information about when
to use them and create them and added to PAYGO plans.

---------

Co-authored-by: Aaron Shekey <[email protected]>
  • Loading branch information
samcrichard and aaronshekey authored Oct 12, 2023
1 parent 363d82a commit 9dfe370
Showing 1 changed file with 22 additions and 30 deletions.
52 changes: 22 additions & 30 deletions docs/user-management/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ ngrok supports two enforcement options once you have configured your identity pr

## Bot Users {#bot-users}

### What is a Bot User?

A Bot User is a service account that owns a set of credentials - authtokens, API keys, and SSH keys - independently of a person. You can see and manage your bot users in the [ngrok Dashboard](https://dashboard.ngrok.com/users/bots).

Bot Users are similar to [Users](#users) but they are intended for automated
systems that programmatically interact with your ngrok accounts either by
starting ngrok Agents or making requests to the API.
Expand All @@ -35,42 +39,34 @@ Bot Users differ from Users in a few important ways:

- Bot Users may not log into the Dashboard
- Bot Users may not be a member of more than one Account
- If your Bot Users do not counta

Bot Users may be
- Bot users do not count against any seat counts or limits.
- Bot users can only be leveraged in ngrok pay-as-you-go plans.

- Does not count as a standard user against your ngrok seat count
- May be attached to services that consume ngrok platform resources and can trigger overages. These areas include metrics like bandwidth, total sessions and endpoints, auth tokens, API tokens, and more.
- Has limited functionality
- Cannot log into the ngrok Dashboard
- Cannot be assigned or shared among multiple accounts
- Has some great benefits
- Credentials that are unique to a specific service or function instead of being connected to a person. A standard user may leave the account or want to rotate their credentials, and these actions should not impact production services running in ngrok.
- Events are attributed to the Bot User and can help you better understand what a specific production service in ngrok is doing, even when there are multiple production services in the same account.
- Can be deactivated to temporarily suspend all credentials associated with it
- Can be deleted to immediately revoke and delete all credentials associated with it
Bot Users facts and limitations:

### What is a Bot User?
- Bot users may be attached to services that consume ngrok platform resources and can trigger overages. These areas include metrics like bandwidth, total sessions and endpoints, auth tokens, API tokens, and more.
- Bot users have limited functionality:
- Bot users cannot log into the ngrok Dashboard
- Bot users cannot be assigned or shared among multiple accounts
- Benefits of bot users:
- Credentials that are unique to a specific service or function can be connected to a bot user instead of being connected to a person. A standard user may leave the account or want to rotate their credentials, and these actions should not impact production services running in ngrok.
- Events are attributed to a Bot User and can help you better understand what a specific production service in ngrok is doing, even when there are multiple production services in the same account.
- Bot users can be deactivated to temporarily suspend all credentials associated with it—making ngrok more secure.
- Bot users can be deleted to immediately revoke and delete all credentials associated with it—making ngrok more secure.

A Bot User is a service account that owns a set of credentials - authtokens, API keys, and SSH keys - independently of a person. You can see and manage your bot users in the [ngrok Dashboard](https://dashboard.ngrok.com/users/bots).
### How do I create a Bot User? {#bot-user-creation}

### A Bot User: {#bot-user}
Access the [ngrok Dashboard](https://dashboard.ngrok.com/users/bots) to create a new bot user.
Navigate to the "Users" section of the left hand navigation, and then "Bot Users".

- Does not count as a standard user against your ngrok seat count
- May be attached to services that consume ngrok platform resources and can trigger overages. These areas include metrics like bandwidth, total sessions and endpoints, auth tokens, API tokens, and more.
- Has limited functionality
- Cannot log into the ngrok Dashboard
- Cannot be assigned or shared among multiple accounts
- Has some great benefits
- Credentials that are unique to a specific service or function instead of being connected to a person. A standard user may leave the account or want to rotate their credentials, and these actions should not impact production services running in ngrok.
- Events are attributed to the Bot User and can help you better understand what a specific production service in ngrok is doing, even when there are multiple production services in the same account.
- Can be deactivated to temporarily suspend all credentials associated with it
- Can be deleted to immediately revoke and delete all credentials associated with it
Bot users are available on ngrok pay-as-you go plans.

### When should I use a Bot User? {#bot-user-use-cases}

A Bot User is the best suited to own the credentials of shipped products, devices, and integrations in production. The ideal flow is a credential you can associate with a specific task, keep active, and can rotate on a predictable schedule because it is unique to that integration, service, or function.

Bot users are available on ngrok pay-as-you go plans.

### When should I not use a Bot User? {#bot-user-vs-user}

A Bot User is very useful, but it is not a good subsitute for a standard ngrok User. When a developer is building with ngrok they may need to rotate credentials after adding them to a build environment or accidentally committing them to a repository. The developer needs to be able to use the ngrok dashboard to see endpoint status, make configuration changes, and manage their own credentials, which a Bot User cannot do.
Expand All @@ -82,7 +78,3 @@ When you delete a Bot User, all credentials owned the user are immediately revok
### Can I move my former employees credentials (API keys, authtokens, SSH keys) to a Bot User? {#bot-user-existing-credentials}

Credentials are assigned an owner when they are created and the owner cannot be changed. Access the [ngrok Dashboard](https://dashboard.ngrok.com/users/bots) to create a new bot user.

### How come I didn't know ngrok had Bot Users? {#bot-user-launch}

We are continuously improving the ngrok platform with new features! We launched Bot Users in early 2023 and are excited to see our customers adopt this functionality.

1 comment on commit 9dfe370

@vercel
Copy link

@vercel vercel bot commented on 9dfe370 Oct 12, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Successfully deployed to the following URLs:

ngrok-docs – ./

ngrok-docs-git-main-ngrok-dev.vercel.app
ngrok-docs.vercel.app
ngrok-docs-ngrok-dev.vercel.app

Please sign in to comment.