> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/developer-guide/platform-administration/administration/user-authentication-and-autorization/login-flow.md).

# Login flow

You can log in to the Digibee Integration Platform in two ways:

* [With Digibee credentials](#id-3ingd8lvv5ai)
* [Through an Identity Provider (IdP)](#crldaax16nm3)

## Login with Digibee credentials <a href="#id-3ingd8lvv5ai" id="id-3ingd8lvv5ai"></a>

### First access <a href="#qkx2jfexd4bk" id="qkx2jfexd4bk"></a>

If you want to access the Digibee Integration Platform for the first time, ask your access manager to create a user for you. For more information, see our [documentation on creating a user](/documentation/developer-guide/platform-administration/administration/new-access-control/users.md).

You will receive an email asking you to set an access password. Once you have set up your access password, log in to the Digibee Integration Platform with your credentials and, if applicable, the realm you want to access.

If you have configured two-factor authentication, you will also need to enter the verification code.

{% hint style="info" %}
Logging in with Digibee credentials can be blocked by the access managers in your realm. In this case, you must log in through an IdP. You can read more about this in our article [Authentication rules](/documentation/developer-guide/platform-administration/administration/identity-provider-integration/idp-accesses.md).
{% endhint %}

### **Password policy**

To protect your security, we have the following criteria for creating passwords:

* It must be between **8 and 16 characters long**.
* It must contain at least **one capital letter**.
* It must contain at least **one lowercase letter**.
* It must contain at least **one special character**.
* It must contain at least **one number**.
* It expires **every 15 days**.
* **It must not be one of the last three passwords used.**

{% hint style="info" %}
For security reasons, Digibee requires its users to change their passwords every 15 days. If you try to log in with an expired password, you will be redirected to the Change password page.
{% endhint %}

## Login using an identity provider (IdP) <a href="#crldaax16nm3" id="crldaax16nm3"></a>

Another way to log in to Digibee is to use an Identity Provider (IdP). To use this type of login, you must first integrate your IdP with Digibee. Learn more about the [integration of Identity Providers](/documentation/developer-guide/platform-administration/administration/identity-provider-integration.md).

To log in to the Digibee Integration Platform through an IdP, first log in to your IdP. Then, when you log in to the Digibee Integration Platform, click the button for the IdP you are using, as shown below.

<figure><img src="/files/wUegX22weK1PX3IoTDY3" alt=""><figcaption><p>Identity provider login page</p></figcaption></figure>

## Best practices when logging in <a href="#a77cp97ohqcd" id="a77cp97ohqcd"></a>

* Make sure your browser is up to date.
* Deactivate plugins that may conflict with reCAPTCHA.
* Remove or deactivate extensions that perform automations.
* Delete cookies and/or browser history data.
* Enable two-factor verification offered by the Digibee Integration Platform. To learn more, read our documentation on [how to activate and deactivate two-factor authentication](/documentation/developer-guide/platform-administration/administration/user-authentication-and-autorization/two-factor-authentication.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/developer-guide/platform-administration/administration/user-authentication-and-autorization/login-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.