Skip to content

Commit 884a673

Browse files
Update add-users.md to clarify Azure AD/Entra authentication is mandatory
Co-Authored-By: [email protected] <[email protected]>
1 parent 1b78c3c commit 884a673

File tree

1 file changed

+16
-11
lines changed

1 file changed

+16
-11
lines changed

add-users.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ This guide explains how to add and manage users in ImmyBot, including different
44

55
## User Authentication Methods
66

7-
ImmyBot supports several authentication methods:
7+
ImmyBot mandates authentication against Azure AD/Entra ID:
88

9-
1. **Azure AD Integration**: Recommended for organizations using Microsoft 365
10-
2. **Email Invitation**: Manual invitation process for individual users
9+
1. **Azure AD/Entra ID Integration**: Required for all ImmyBot installations
10+
2. **Email Invitation**: Available for inviting users already in your Azure AD/Entra directory
1111
3. **Self-Registration**: Allow users to request access (with admin approval)
1212

1313
## Adding Users via Self-Registration
@@ -39,15 +39,20 @@ For more controlled user addition:
3939
6. Click **Send Invitation**
4040
7. The user will receive an email with instructions to complete registration
4141

42-
## Adding Users via Azure AD
42+
## Adding Users via Azure AD/Entra ID
4343

44-
If you've configured Azure AD integration:
44+
Azure AD/Entra ID integration is mandatory for ImmyBot authentication:
4545

46-
1. Navigate to **Settings** > **Authentication**
47-
2. Ensure Azure AD integration is configured
48-
3. Users can now sign in with their Microsoft credentials
49-
4. New users will be automatically created when they first sign in
50-
5. Assign appropriate roles to new users
46+
1. Navigate to **Settings** > **Authentication** to configure your Azure AD/Entra integration
47+
2. There are two ways to add users from Azure AD/Entra:
48+
- **Basic Consent Level**: You'll need to know the user's ID (GUID) to add them
49+
- **Recommended Consent Level**: Users can be added directly from the Persons page without knowing their GUID
50+
3. To increase the consent level to recommended settings:
51+
- Navigate to **Settings** > **Authentication** > **Azure AD**
52+
- Click on **Increase Consent Level**
53+
- Follow the prompts to grant additional permissions
54+
4. Users can now sign in with their Microsoft credentials
55+
5. Assign appropriate roles to new users after they sign in
5156

5257
## Managing Existing Users
5358

@@ -77,7 +82,7 @@ After adding users, you might want to explore:
7782

7883
- [User Roles and Security](./user-roles.md) - Learn about user permissions and security
7984
- [Tenant Management](./tenant-management.md) - Configure tenant access for users
80-
- [Azure AD Integration](./azure.md) - Set up Azure AD for seamless authentication
85+
- [Azure AD/Entra ID Integration](./azure-graph-permissions-setup.md) - Configure Azure AD/Entra permissions
8186

8287
---
8388

0 commit comments

Comments
 (0)