Connection
Setup
1
Register an application
Register an app for
Klef in your tenant, then add a client secret to it.
2
Grant the permissions
Add the Microsoft Graph application permissions under Permissions and
grant admin consent
for the tenant.
3
Add Exchange access
Only needed to manage address list visibility and mail forwarding. Give the app the
Exchange.ManageAsApp role and a
certificate to sign in to Exchange Online
with.Permissions
Grant each as an application permission, with admin consent. Klef needs these Microsoft Graph permissions:User.ReadWrite.All(orDirectory.ReadWrite.All) to read and write users.User.EnableDisableAccount.All(orUser.ReadWrite.All) to enable and disable accounts.GroupMember.ReadWrite.All(orGroup.ReadWrite.All) to manage group membership.Organization.Read.All(orLicenseAssignment.Read.All, orDirectory.Read.All) to read the tenant’s licenses.User-PasswordProfile.ReadWrite.Allto reset passwords.
User-Phone.ReadWrite.All(orUser.ReadWrite.All) to update phone numbers.RoleManagement.ReadWrite.Directoryto assign directory roles. It lets the app assign any role, Global Administrator included, so grant it only where Klef manages roles.LicenseAssignment.ReadWrite.All(orGroup.ReadWrite.All) to assign licenses to groups.Domain.Read.All(orDirectory.Read.All) to turn away a user in a federated domain before Graph does.UserAuthenticationMethod.ReadWrite.AllandPolicy.Read.Allto issue Temporary Access Passes. Both are required when First sign-in is set to Temporary Access Pass, which the authentication methods policy must also allow.Exchange.ManageAsApp, with an Entra role such as Exchange Administrator on the app’s service principal, to manage address list visibility and mail forwarding. It applies only when the connection has Exchange settings.
Settings
microsoft_entra.user
Fields
Credential: password
Password. Apassword { } block in a target issues it.
Credential: temporary_access_pass
Temporary Access Pass. Atemporary_access_pass { } block in a target issues it, and status = removed inside it revokes it.
