> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/en/getting-started/setup/login.md).

# Sign in and manage authentication

Sign in to Dastra with a password, a passkey, an email link or SSO, and secure your account.

This page explains how to sign in to Dastra, how to reset your password and how to strengthen the security of your account: strong authentication, passkeys and active sessions.

## Sign in to Dastra

Signing in takes two steps: you enter your email address first, then you choose how to authenticate.

### With your email address and password

1. Go to [app.dastra.eu](https://app.dastra.eu).
2. Enter your **Work email Address**, then click **Continue**.
3. Enter **Your password**, then click **Connect**.

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-fec40b56e06496fa8d1e5d47e5a2e719e9e56225%2Fgetting-started-login-1.png?alt=media" alt="First sign-in step: work email address and Continue button"><figcaption><p>First step: the email address</p></figcaption></figure>

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-a76aacd2d2cb73e33e49828b608e80a5002daf06%2Fgetting-started-login-2.png?alt=media" alt="Second sign-in step: password and other sign-in options"><figcaption><p>Second step: the password and the other sign-in options</p></figcaption></figure>

{% hint style="info" %}
Tick **Remember me** only on a personal device.
{% endhint %}

### With a Google or Microsoft account

On the first step, under **Or**, click **Log in with** followed by Google or Microsoft, then follow the provider's procedure. You can attach an external account to your Dastra account in **Account security** > **Login providers**.

### With SSO

If your organization has configured [single sign-on (SSO)](https://doc.dastra.eu/en/features/settings/sso.md), sign in with your identity provider.

1. On the first step, click **Sign in with SSO**.
2. Enter **Your organization's email address or username**, then click **Continue**.
3. Follow your organization's authentication procedure. Dastra then redirects you to your workspace.

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-62b6e2a4e86514b6e239d123089154942db9fa2b%2Fgetting-started-login-3.png?alt=media" alt="SSO sign-in page: SSO identifier field and Continue button"><figcaption><p>Signing in with SSO</p></figcaption></figure>

With SSO, your credentials stay with your identity provider: Dastra does not receive your password.

### With a passkey

A passkey replaces the password with your fingerprint, your face or your device PIN. On the second step, click **Sign in with a passkey**.

You register your passkeys in **Account security** > **Manage my passkeys**. See [Passkeys](https://doc.dastra.eu/en/security/passkey.md).

### With a login link sent by email

On the second step, click **Email me a login link**. Dastra sends a link to your email address that signs you in without a password.

### Choose the hosting region

When your Dastra environment offers several hosting regions, the sign-in page shows a **Hosting region** field with the current region: **Europe region (default)** or **Bleu cloud France**. Click the field to open the other region, then sign in there.

Click the **?** button next to the field (**Learn more about hosting regions**) to compare the regions. A tenant is hosted in a single region, and the two regions are neither mirrored nor synchronized: an account of one region cannot sign in on the other. To move an existing tenant to the other region, use **Contact our sales team** in the same window. See [Dastra on Bleu](https://doc.dastra.eu/en/security/bleu.md) for the addresses and the hosting details of each region.

## Reset your password

1. On the second sign-in step, click **Forgot your password ?**.
2. Enter the email address linked to your account.
3. Open the email you receive and follow the reset link.
4. Choose a new password.

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-c235fb2b76f57d57e522935b6f67e83493f2156a%2Fgetting-started-login-4.png?alt=media" alt="Password reset page"><figcaption><p>The password reset page</p></figcaption></figure>

If the link no longer works, start again. Once signed in, you can also click **Change Password** in **Account security**: Dastra sends you an email with a reset link.

## Manage the security of your account

Open the profile menu at the top right, click **User profile**, then click **Account security** in the left menu. The page groups:

* **Password**: the **Change Password** button;
* strong authentication, also called two-factor authentication;
* passkeys;
* **Login providers**;
* **Actives sessions**;
* your **Activity history**.

<figure><img src="https://2697025545-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-1972196547%2Fuploads%2Fgit-blob-79ed88fdc61afa154faf98e1bc1d9b376f45faf1%2Fgetting-started-login-5.png?alt=media" alt="Account security page with the password, strong authentication and passkeys sections"><figcaption><p>The Account security page</p></figcaption></figure>

### Enable strong authentication

Strong authentication adds a step to sign-in: a 6-digit code generated by an authenticator app on your phone.

1. In **Account security**, click **Enable the two factors authentication**.
2. Scan the QR code with an authenticator app (Microsoft Authenticator, Google Authenticator, 1Password, and so on).
3. Enter the generated code to confirm the activation.
4. Keep the recovery code displayed during activation.

{% hint style="warning" %}
The recovery code gives you back access to your account if you lose your authenticator app. Without it, you must ask the organization owner to reset the strong authentication of your account.
{% endhint %}

Once strong authentication is enabled, you enter your password, then the 6-digit code from your app. See [Strong authentication](https://doc.dastra.eu/en/security/mfa.md).

### Manage active sessions

1. In **Account security**, find the **Actives sessions** section: it lists the devices and browsers connected to your account.
2. Click **Revoke** next to the session to close.

Close any session you do not recognize immediately.

## Security best practices

* Use a long, unique password for Dastra.
* Never share your credentials, even internally.
* Enable strong authentication or register a passkey.
* Sign out on shared or public devices.
* Check your active sessions regularly.

## See also

* [Set up your user profile](https://doc.dastra.eu/en/getting-started/setup/profile.md)
* [Notifications](https://doc.dastra.eu/en/features/settings/notifications.md)
* [Security](https://doc.dastra.eu/en/security/general.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/en/getting-started/setup/login.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
