diff --git a/dev/breeze/doc/03_developer_tasks.rst b/dev/breeze/doc/03_developer_tasks.rst index 5babb592f3c27..8a7e3bcd17654 100644 --- a/dev/breeze/doc/03_developer_tasks.rst +++ b/dev/breeze/doc/03_developer_tasks.rst @@ -132,12 +132,48 @@ You can connect to these ports/databases using: If you do not use ``start-airflow`` command. You can use ``tmux`` to multiply terminals. You may need to create a user prior to running the API server in order to log in. -This can be done with the following command: + +**Authentication and User Management** + +The authentication method depends on which auth manager is configured: + +**SimpleAuthManager (Default in Airflow 3.x)** + +SimpleAuthManager is the default authentication manager and comes pre-configured with test username and passwords for development: + +.. code-block:: + + * admin:admin (Admin role) + * viewer:viewer (Viewer role) + * user:user (User role) + * op:op (Operator role) + +These users are automatically available when using SimpleAuthManager and require no additional setup. + +**FabAuthManager** + +When using FabAuthManager, you can create users manually: .. code-block:: bash airflow users create --role Admin --username admin --password admin --email admin@example.com --firstname foo --lastname bar +Or use the ``--create-all-roles`` flag with ``start-airflow`` in dev mode to automatically create test users: + +.. code-block:: bash + + breeze start-airflow --dev-mode --create-all-roles --auth-manager FabAuthManager + +This will create the following test users: + +.. code-block:: + + * admin:admin (Admin role) + * viewer:viewer (Viewer role) + * user:user (User role) + * op:op (Op role) + * testadmin:testadmin (Admin role) + .. note:: ``airflow users`` command is only available when `FAB auth manager `_ is enabled. diff --git a/dev/breeze/doc/images/output_start-airflow.svg b/dev/breeze/doc/images/output_start-airflow.svg index 852322c8133c7..17551b8bff590 100644 --- a/dev/breeze/doc/images/output_start-airflow.svg +++ b/dev/breeze/doc/images/output_start-airflow.svg @@ -1,4 +1,4 @@ - +