---
title: "Installation"
manual: "Azure Login"
version: "4.0"
permalink: "https://docs.typo3.org/permalink/oliverkroener/ok-azure-login:installation@4.0"
source: "Installation.rst"
rendered: "2026-11-02T01:10:24+00:00"
---

# Installation {#installation}

## Install with Composer {#installation-composer}

> [!NOTE]
> Composer is the recommended way to install this extension.

Install the extension via Composer:

```bash
composer req oliverkroener/ok-azure-login
```

After installation, update the database schema to create the configuration table:

```bash
vendor/bin/typo3 database:updateschema
```

See also [Installing extensions](https://docs.typo3.org/m/typo3/tutorial-getting-started/13.4/en-us/Extensions/InstallingExtensions.html#installing-extensions)
in the TYPO3 Getting Started guide.

## Include the static TypoScript {#installation-typoscript}

1.  In the TYPO3 backend, go to the **Template** module
1.  Select the root page of your site
1.  Choose **Info/Modify** and click **Edit the whole template record**
1.  Switch to the **Includes** tab
1.  Add **Azure Login** from the list of available static templates

## Add the content elements {#installation-content-element}

The extension provides two content elements, available under the **Azure Login**
group in the New Content Element Wizard:

-   **Azure Login**

    Renders a "Sign in with Microsoft" button. When a user authenticates via
    Microsoft Entra ID, the extension matches their email to an existing
    `fe_users` record and logs them in.

-   **Azure Logout**

    Renders a "Sign out" button for logged-in users. Can optionally redirect
    to the Microsoft logout endpoint to sign the user out of Microsoft as well.

To add them:

1.  Go to the **Page** module and select the page where the login or logout button should appear
1.  Click **Create new content element**
1.  Select from the **Azure Login** group: either **Azure Login** or **Azure Logout**
1.  Configure the element settings (button theme, redirect URL, etc.) as needed
1.  Save and clear caches

## Backend login {#installation-backend-login}

The extension automatically registers a backend login provider. Once configured
(see [Configuration](https://docs.typo3.org/permalink/oliverkroener/ok-azure-login:configuration@4.0)), a "Sign in with Microsoft" button
appears as a separate tab on the TYPO3 backend login screen at `/typo3/`.

No additional setup is needed for backend login beyond configuring the Azure
credentials. The backend redirect URI is automatically derived from the route
configuration and shown as a read-only field with a copy button in the backend
module. Register this URL in your Azure app registration.