---
agentTools:
  projectIndex: https://docs.project-fifo.net/llms.txt
---

# Users

This section explains the detail view available for the users managed by FiFo.

# Authentication

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/4SCR8wGNSoqCGsY2wOKI_09users01authentication.png",
        "09users01authentication.png",
        "2734",
        "2002",
        "#337d9e",
        ""
      ]
    }
  ]
}
[/block]

Authentication **Authorization** sections lets you manage and change the users authentication, you can change the *password*, add or remove *ssh keys* and enable MFA by adding [YubiKeys](https://www.yubico.com).

[block:callout]
{
  "type": "warning",
  "title": "YubiKeys",
  "body": "It is always advised to enable at least two YubiKeys. Having a secondary key enabled allows you to recover an account when the primary key is list."
}
[/block]

# Permissions

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/WQcTNAUvTHeeklP7JQ5a_09users02permissions.png",
        "09users02permissions.png",
        "2734",
        "2002",
        "#4d737e",
        ""
      ]
    }
  ]
}
[/block]

The **Permissions** tab allows to configure a users own permissions, see the section on [Permissions](https://docs.project-fifo.net/docs/permissions) for details.

[block:callout]
{
  "type": "warning",
  "title": "Roles",
  "body": "It is highly recommended to handle most of permissions via Roles and not directly on a user!"
}
[/block]

# Roles

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/emtRBIoQBmUvPzSVuhUp_09users03roles.png",
        "09users03roles.png",
        "2734",
        "2002",
        "#5394ae",
        ""
      ]
    }
  ]
}
[/block]

The **Roles** tab lets you manage which roles a user belongs to, add new roles or remove old ones. All changes take immediate effect existing tokens and logins will be directly affected.

# Orgs

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/F1jPhz2RXO8ScA3G4asP_09users04orgs.png",
        "09users04orgs.png",
        "2734",
        "2002",
        "#5394ad",
        ""
      ]
    }
  ]
}
[/block]

The **Orgs** tab allows to manage the users Organizations, Add remove them and select which one active.

# Tokens

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/W9K1sR2SSBevroz95Wg8_09users05tokens.png",
        "09users05tokens.png",
        "2734",
        "2002",
        "#518ba5",
        ""
      ]
    }
  ]
}
[/block]

With the rollout of OAuth2 for authentication the **Tokens** tab lets you manage OAuth2 tokens, revoke them if desired.

Here you also can add API tokens, they are special tokens that will never be time out and can be used to authenticate applications like `pyfi` without requiring to store the password. Upon creation the token will be displayed **once** retrieving it afterwards is impossible.

# Creation

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/AgJHrL3CTpCXUv3nW53D_12usercreation.png",
        "12usercreation.png",
        "1144",
        "247",
        "#7394a0",
        ""
      ]
    }
  ]
}
[/block]

In the creation tab you can add a new user with a given password.