{"id":19099814,"url":"https://github.com/AzureAD/microsoft-authentication-cli","last_synced_at":"2025-04-18T17:32:05.603Z","repository":{"id":37055861,"uuid":"463357839","full_name":"AzureAD/microsoft-authentication-cli","owner":"AzureAD","description":"A command line utility for Azure authentication.","archived":false,"fork":false,"pushed_at":"2024-05-27T23:30:01.000Z","size":1210,"stargazers_count":37,"open_issues_count":26,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-28T08:48:09.018Z","etag":null,"topics":["auth","authentication","azure","identity"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AzureAD.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-02-25T01:33:08.000Z","updated_at":"2024-05-29T21:14:53.945Z","dependencies_parsed_at":"2024-01-10T03:45:37.425Z","dependency_job_id":"8fa2f994-7ac4-4982-88d9-f897da988c92","html_url":"https://github.com/AzureAD/microsoft-authentication-cli","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzureAD%2Fmicrosoft-authentication-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzureAD%2Fmicrosoft-authentication-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzureAD%2Fmicrosoft-authentication-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzureAD%2Fmicrosoft-authentication-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AzureAD","download_url":"https://codeload.github.com/AzureAD/microsoft-authentication-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223783108,"owners_count":17201903,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auth","authentication","azure","identity"],"created_at":"2024-11-09T03:52:18.394Z","updated_at":"2025-04-18T17:32:05.597Z","avatar_url":"https://github.com/AzureAD.png","language":"C#","funding_links":[],"categories":["azure"],"sub_categories":[],"readme":"# Microsoft Authentication CLI\n\n[![Tests](https://img.shields.io/github/actions/workflow/status/AzureAd/microsoft-authentication-cli/.github/workflows/dotnet-test.yml?branch=main\u0026style=for-the-badge\u0026logo=github)](https://github.com/AzureAD/microsoft-authentication-cli/actions/workflows/dotnet-test.yml)\n[![Release](https://img.shields.io/badge/Release-0.9.1-orange?style=for-the-badge\u0026logo=github)](https://github.com/AzureAD/microsoft-authentication-cli/releases/tag/0.9.1)\n![GitHub release (latest by SemVer)](https://img.shields.io/github/downloads/azuread/microsoft-authentication-cli/0.9.1/total?logo=github\u0026style=for-the-badge\u0026color=blue)\n[![License](https://shields.io/badge/license-MIT-purple?style=for-the-badge)](./LICENSE.txt)\n\n---\n\n`AzureAuth` is a CLI wrapper for performing AAD Authentication. It makes use of [MSAL](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet) for authentication and caching.\n\nThe CLI is designed for authenticating and returning an access token for public client AAD applications. This acts like a credential provider for Azure Devops and any other [public client app](https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-client-applications).\n\n# Platform Support\n\n\u003e [!WARNING]\n\u003e AzureAuth support for Ubuntu was suspended as of version 0.8.6. Please file an issue if this lack of support causes issues for you.\n\n\u003e [!IMPORTANT]\n\u003e At this time AzureAuth does **NOT** support headless Linux environments unless you are using device code flow.\n\u003e See [msal#3033](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/3033)\n\u003e and [#410](https://github.com/AzureAD/microsoft-authentication-cli/issues/410) for more information.\n\n| Operating System                           | Integrated Windows Auth | Auth Broker Integration | Web Auth Flow            | Device Code Flow | Token Caching | Multi-Account Support           |\n| ------------------------------------------ | ----------------------- | ----------------------- | ------------------------ | ---------------- | ------------- | ------------------------------- |\n| Windows                                    | ✅                      | ✅                      | ✅                      | ✅              | ✅          | ⚠️ `--domain` account filtering |\n| OSX (MacOS)                                | N/A                      | ⚠️ via Web Browser      | ✅                      | ✅             | ✅          | ⚠️ `--domain` account filtering |\n| Ubuntu (Linux)                             | N/A                      | ⚠️ via Edge             | ⚠️ in GUI environments | ✅        | ⚠️ in GUI environments. See [msal#3033](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/3033)      | ⚠️ `--domain` account filtering |\n\n\u003cbr/\u003e\n\n# Installation\n\n## Windows\n\nOn Windows we provide a PowerShell bootstrap script, which will download and extract the application to\n`%LOCALAPPDATA%\\Programs\\AzureAuth` and automatically add the `azureauth` binary to your `$PATH`. You can set an\nalternative installation location via the `$AZUREAUTH_INSTALL_DIRECTORY` environment variable. We don't currently\nprovide a means of downloading the latest release, so you **must** specify your desired version via the\n`$AZUREAUTH_VERSION` environment variable.\n\nTo install the application, run\n\n```powershell\n# 0.9.1 is an example. See https://github.com/AzureAD/microsoft-authentication-cli/releases for the latest.\n$env:AZUREAUTH_VERSION = '0.9.1'\n$script = \"${env:TEMP}\\install.ps1\"\n$url = \"https://raw.githubusercontent.com/AzureAD/microsoft-authentication-cli/${env:AZUREAUTH_VERSION}/install/install.ps1\"\n[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12\nInvoke-WebRequest $url -OutFile $script; if ($?) { \u0026$script }; if ($?) { rm $script }\n```\n\n**Note**: The script does not signal currently running processes to update their environments, so you'll need to\nrelaunch applications before the `$PATH` changes take effect.\n\n**Note**: Uninstalling can be done with the uninstallation script. [Read more](docs/uninstall.md)\n\n## macOS\n\nOn macOS we provide a shell bootstrap script, which will download and extract the application to `$HOME/.azureauth`\nand automatically add the `azureauth` binary to your `$PATH`. You can set an alternative installation location via the\n`$AZUREAUTH_INSTALL_DIRECTORY` environment variable. We don't currently provide a means of downloading the latest\nrelease, so you **must** specify your desired version via the `$AZUREAUTH_VERSION` environment variable.\n\nTo install the application, run\n\n```bash\n# 0.9.1 is an example. See https://github.com/AzureAD/microsoft-authentication-cli/releases for the latest.\nexport AZUREAUTH_VERSION='0.9.1'\ncurl -sL https://raw.githubusercontent.com/AzureAD/microsoft-authentication-cli/$AZUREAUTH_VERSION/install/install.sh | sh\n```\n\n**Note**: The script currently only updates the `$PATH` in `~/.bashrc` and `~/.zshrc`. It does not update the environment\nof currently running processes, so you'll need to relaunch applications (or source your shell profile) before the `$PATH`\nchanges take effect.\n\n# Using AzureAuth\n\nInstructions on using AzureAuth CLI in your applications are available [here](docs/usage.md).\n\n# Data Collection Is Off By Default\nNo telemetry will be collected unless you set the `AZUREAUTH_APPLICATION_INSIGHTS_INGESTION_TOKEN` environment variable\nor the registry key `ApplicationInsightsIngestionToken` under `HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\AzureAuth`\nto a valid [Application Insights](https://docs.microsoft.com/en-us/azure/azure-monitor/app/app-insights-overview)\ningestion token.\n\nIf you choose to turn data collection on, the software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use\nthis information to provide services and improve our products and services. You may turn off the telemetry as described\nin the repository. There are also some features in the software that may enable you and Microsoft to collect data from\nusers of your applications. If you use these features, you must comply with applicable law, including providing\nappropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy\nstatement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and\nuse in the help documentation and our privacy statement. Your use of the software operates as your consent to these\npractices.\n\n# Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow [Microsoft’s Trademark \u0026 Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft\nsponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzureAD%2Fmicrosoft-authentication-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAzureAD%2Fmicrosoft-authentication-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAzureAD%2Fmicrosoft-authentication-cli/lists"}