# Widget authentication

{% hint style="success" %}
**Access Type**: Admin
{% endhint %}

Widget authentication refers to the provider/method used to authenticate an end-user in the Didomi consents API so that Didomi can successfully display, set and retrieve the end-user's record. In this article, we will cover:

* [Widget authentication providers](#widget-authentication-providers)
* [Configure default authentication providers](#configure-default-authentication-providers)

### Widget authentication providers

Refer to the tabs below for more information on the available providers/methods your organization can select as the default for your preferences and privacy request widgets.

{% tabs %}
{% tab title="One-Time Password (OTP)" %}
The One-Time Password authentication method sends the end-user an email with a 6-digit code that must be entered into the widget in order to successfully log in.

{% hint style="info" %}
Organization accounts created after July 4, 2023 will have One-Time Password (OTP) configured as the default widget authentication provider
{% endhint %}

<figure><img src="/files/zUemSII8ZqbzmX4FqZio" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Magic Link" %}
The Magic Link authentication method sends the end-user an email containing a link that will grant them access to the widget.

{% hint style="info" %}
Organization accounts created before July 4, 2023 will have Magic Link configured as the default widget authentication provider
{% endhint %}

<figure><img src="/files/rn65KzfN9PMEsUJtDVe7" alt="" width="375"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
While not available via the Didomi console, your organization also has the option to use server authentication as the widget authentication provider to authenticate end-users from your backend to create a more seamless experience. This provider option is only available via the Didomi  API. [Click here](mailto:undefined) for more information.
{% endhint %}

### Configure default authentication providers

In this section, we will cover how to configure/change the default widget authentication provider used for all of your preferences and privacy request widgets via the Didomi console.

{% hint style="warning" %}
**Note**: Widget authentication providers can be set on a per widget basis via the Didomi API. [Click here](https://developers.didomi.io/api-and-platform/widgets/privacy-widgets/authentication/manage-authentication-providers#manage-authentication-within-a-widget) for more information.
{% endhint %}

Click **My organization** in the header and select **Organization settings** from the drop-down menu.

<figure><img src="/files/FCHJab40y4bwexB9nEGt" alt="" width="563"><figcaption></figcaption></figure>

Click the **Widget Authentication** tab.

<figure><img src="/files/LpMOCY3b2MDzYFYdyhp3" alt="" width="563"><figcaption></figcaption></figure>

Use the provided cards to select between **One-Time Password** or **Magic Link** as the default widget authentication provider.

Click **Save** when finished.

<figure><img src="/files/bCT27evQwdrQG6H2p7SO" alt="" width="563"><figcaption></figcaption></figure>

Confirm your selection in the subsequent modal and click **Yes, continue**.

<figure><img src="/files/uKHmORv0rCOOmyXOPD8c" alt="" width="361"><figcaption></figcaption></figure>


---

# Agent Instructions: 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.didomi.io/organization-and-account-settings/widget-authentication.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.