# Microsoft Auth

{% stepper %}
{% step %}
**Navigate to security settings**

Go to the settings page of your account: [https://mysignins.microsoft.com/security-info](https://mysignins.microsoft.com/security-info) and start the setup of Two-step verification

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/9f44d8d699c3/microsoft-security-info-add-signin-method.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Set up Two-step verification**

Choose to set it up with a different Authenticator app.

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/ef4de220fd61/microsoft-add-signin-method-authenticator.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Select a different authentication app**

Click "Set up a different authentication app".

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/b2b9e6c909c3/microsoft-install-authenticator-different-app.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Get secret instead of code**

When seeing the QR code, select the option "I can't scan the bar code"

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/93265a85e998/microsoft-scan-qr-code-cant-scan.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Copy the key**

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/65a48f46e928/microsoft-enter-authenticator-secret-key.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Store key in password manager**

Now add the key for the password manager in a password manager of choice. We recommend using a password manager that easily allows for the extraction of the key like 1Password or Bitwarden.
{% endstep %}

{% step %}
**Fulfill the flow and enable 2-Step Verification**

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/ad061e289d47/Screenshot-2025-12-19-at-17.55.13.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Set up authentication in Aikido Pentest**

Write your instructions in a similar format as below

```
Step 1: Go to domain.com/login
Step 2: Select "Microsoft Login". You will be redirected to login.microsoftonline.com
Step 3: provide the following credentials:
- username: <username>
- password: <password>
Step 4: Generate the TOTP and log in
Success criteria: When successfully logged in, you will see "Hello Aikido" on the homescreen
```
{% endstep %}

{% step %}
**Add the TOTP URL**

Add the key in the correct base32 format. When adding the key from Microsoft, make sure to remove the spaces

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/482c63d2090a/Screenshot-2026-05-19-at-13.40.02-1.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
