Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 72 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
# Azure Login Action

- [Azure Login Action](#azure-login-action)
- [Supported Versions](#supported-versions)
- [Version Selection](#version-selection)
- [Major-version tag](#major-version-tag)
- [Exact version tag](#exact-version-tag)
- [Branch reference](#branch-reference)
- [Commit SHA](#commit-sha)
- [Security Updates](#security-updates)
- [Input Parameters](#input-parameters)
- [`client-id`](#client-id)
- [`subscription-id`](#subscription-id)
Expand Down Expand Up @@ -48,6 +55,70 @@ Azure Login Action supports different ways of authentication with Azure.
> [!WARNING]
> Avoid using managed identity login on self-hosted runners in public repositories. Managed identities enable secure authentication with Azure resources and obtain Microsoft Entra ID tokens without the need for explicit credential management. Any user can open pull requests against your repository and access your self-hosted runners without credentials. See more details in [self-hosted runner security](https://docs.github.com/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#self-hosted-runner-security).

## Supported Versions

Azure Login follows a major-version support model.

| Version | Status |
| --- | --- |
| v3 | Supported |
| v2 | Maintenance mode (security fixes only) |
| v1 | End of Life (EOL) |

New features are released only to supported versions. Security fixes are released to supported versions and versions in maintenance mode.

Customers are strongly encouraged to use the latest v3 release.

## Version Selection

GitHub Actions users can reference Azure Login using several forms.

### Major-version tag

```yaml
uses: azure/login@v3
```

Receives compatible updates, including security fixes, released to the referenced major version.

### Exact version tag

```yaml
uses: azure/login@v2.4.0
```

Remains pinned to that specific release and does not automatically receive future fixes or updates.

### Branch reference

```yaml
uses: azure/login@master
```

Receives updates from the referenced branch. For stable workflows, use a supported major-version tag or pin to a full-length commit SHA.

### Commit SHA

```yaml
uses: azure/login@<full-length-commit-sha>
```

Remains pinned to that commit and does not automatically receive future fixes or updates.

## Security Updates

Security fixes are released to supported versions and versions in maintenance mode. Customers using exact version tags or commit SHA references must explicitly upgrade to a patched release to receive security fixes.

```yaml
# Automatically receives future v3 security updates
uses: azure/login@v3

# Does not automatically receive future updates
uses: azure/login@v2.4.0
```

Customers using v1 should migrate to v3. End-of-life releases no longer receive updates or security fixes.

## Input Parameters

|Parameter Name|Required?|Type|Default Value|Description|
Expand Down Expand Up @@ -705,4 +776,4 @@ provided by the bot. You will only need to do this once across all repos using o

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
Loading