---
title: configauth
description: Canonical makes open source secure, reliable and easy to use, providing
  support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in
  2004, Canonical operates globally with team members in over 80 countries.
url: https://canonical-com-2934.demos.haus/maas/docs/configauth?format=md
---

*Submit*

# configauth

Configure external authentication.

```
maas configauth [-h] [--candid-agent-file CANDID_AGENT_FILE] [--candid-domain CANDID_DOMAIN] [--candid-admin-group CANDID_ADMIN_GROUP] [--rbac-url RBAC_URL]  [--rbac-service-name RBAC_SERVICE_NAME] [--json]
```

#### Command-line options

| Option | Effect |
| --- | --- |
| -h, --help | show this help message and exit |
| –candid-agent-file CANDID\_AGENT\_FILE | Agent file containing Candid authentication |
|  | information |
| –candid-domain CANDID\_DOMAIN | The authentication domain to look up users in for the |
|  | external Candid server |
| –candid-admin-group CANDID\_ADMIN\_GROUP | Group of users whose members are made admins in MAAS |
| –rbac-url RBAC\_URL | The URL for the Canonical RBAC service to use |
| –rbac-service-name RBAC\_SERVICE\_NAME | Optionally, the name of the RBAC service to register |
|  | this MAAS as. If not provided, a list with services |
|  | that the user can register will be displayed, to |
|  | choose from |
| –json | Return the current authentication configuration as |
|  | JSON |

---

[Previous

commissioning-scripts](https://canonical-com-2934.demos.haus/maas/docs/commissioning-scripts)
[Next

config](https://canonical-com-2934.demos.haus/maas/docs/config)

Last updated 1 year, 4 months ago. [Help improve this document in the forum](https://discourse.maas.io/t/configauth/11378).