<commit_before>:imagesdir: C:\_My Documents\FlowWritingLLC\Projects\Kill Bill\Documentation\killbill-docs\userguide\assets\img\kaui

//Formal location - https://github.com/killbill/killbill-docs/raw/v3/userguide/assets/img/kaui

// /admin_allowed_users

//Mary's directory - C:\_My Documents\FlowWritingLLC\Projects\Kill Bill\Documentation\killbill-docs\userguide\assets\img\kaui

//Ruby30-x64
//Command to convert to PDF:
//Asciidoctor-pdf "C:/_My Documents/FlowWritingLLC/Projects/Kill Bill/Documentation/killbill-docs/userguide/kaui/includes/users.adoc"

//___________________________________________________________________

== Overview

In this guide, "users" refers to those who log in to Kaui to perform actions (add a charge, generate a dry-run invoice, etc.). However, other parts of the documentation also use the term "user" when referring to users of the API.

In order for users to be able to log in and perform tasks in Kaui, you need to create a user profile for each one.

This section explains how to manage users in Kaui, which includes:

* Creating and editing new users
* Assigning roles and tenants to users
* Adding new user roles

This section assumes that you can log in as a Kaui admin or as a user with the correct permissions for working with users, roles, and permissions.

== Additional Resources

For additional information on managing users, roles, and permissions in Kill Bill, see the following:

* https://docs.killbill.io/latest/user_management.html[Users, Roles, and Permissions Management]

* https://killbill.io/blog/multi-tenancy-authorization/[Multi-Tenancy and Authorization]

* https://github.com/killbill/killbill-api/blob/master/src/main/java/org/killbill/billing/security/Permission.java[List of user permissions]

=== Managing Users with a Third-Party System

If your organization uses a third-party system, such as LDAP, Okta, or Auth0, to manage Kill Bill users and roles, first configure them in that system, then add them in Kaui. For more information, see https://docs.killbill.io/latest/user_management.html[Users, Roles, and Permissions Management].

In Kaui, all that's required is to add the username per the <<Add a User>> section, then <<Edit a User, edit the user profile>> to define passwords and roles.

=== Managing Users with Kill Bill

If you are managing users with the Kill Bill database _or_ solely with the `shiro.ini` file, first define the users and roles as described in https://docs.killbill.io/latest/user_management.html[Users, Roles, and Permissions Management].

In Kaui, you must recreate the same users, passwords, etc. For more information, see <<Add a User>> and <<Edit a User>>.

// If you are using the Kill Bill database to store user data, adding a user profile to in Kaui automatically creates it in Kill Bill. <--NOT SURE ABOUT THIS

== Create a New User Role
<commit_msg>writing Users section per comments<commit_after>:imagesdir: C:\_My Documents\FlowWritingLLC\Projects\Kill Bill\Documentation\killbill-docs\userguide\assets\img\kaui

//Formal location - https://github.com/killbill/killbill-docs/raw/v3/userguide/assets/img/kaui

// /admin_allowed_users

//Mary's directory - C:\_My Documents\FlowWritingLLC\Projects\Kill Bill\Documentation\killbill-docs\userguide\assets\img\kaui

//Ruby30-x64
//Command to convert to PDF:
//Asciidoctor-pdf "C:/_My Documents/FlowWritingLLC/Projects/Kill Bill/Documentation/killbill-docs/userguide/kaui/includes/users.adoc"

//___________________________________________________________________

== Overview

In this guide, "users" refers to those who log in to Kaui to perform actions (add a charge, generate a dry-run invoice, etc.). However, other parts of the documentation also use the term "user" when referring to users of the API.

In order for users to be able to log in and perform tasks in Kaui, you need to create a user profile for each one.

This section explains how to manage users in Kaui, which includes:

* Creating and editing users
* Assigning roles and tenants to users
* Creating user roles

This section assumes that you can log in as a Kaui admin or as a user with the correct permissions for working with users, roles, and permissions.

== Additional Resources

For additional information on managing users, roles, and permissions in Kill Bill, see the following:

* https://docs.killbill.io/latest/user_management.html[Users, Roles, and Permissions Management]

* https://killbill.io/blog/multi-tenancy-authorization/[Multi-Tenancy and Authorization]

* https://github.com/killbill/killbill-api/blob/master/src/main/java/org/killbill/billing/security/Permission.java[List of user permissions]

=== Managing Users with a Third-Party System

If your organization uses a third-party system, such as LDAP, Okta, or Auth0, to manage Kill Bill users and roles, first configure them in that system, then add them in Kaui. For more information, see https://docs.killbill.io/latest/user_management.html[Users, Roles, and Permissions Management].

In Kaui, all that's required is to add the username per the <<Add a User>> section, then <<Edit a User, edit the user profile>> to define passwords and roles.

=== Managing Users with Kill Bill

If you are using the Kill Bill database to store user data, adding a user profile in Kaui automatically creates it in Kill Bill.

== Create a New User Role

{'fraction_non_alphanumeric': 0.08278703877130549, 'fraction_numerical': 0.0022476119123431356, 'mean_word_length': 4.638859556494192, 'pattern_counts': {'":': 0, '<': 16, '<?xml version=': 0, '>': 15, 'https://': 11, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1061851', 'n_tokens_mistral': 1554, 'n_tokens_neox': 1478, 'n_words': 620}