Skip to content


Terraform logo

Terraform Provider for Azure Active Directory

NOTE: Version 1.0 and above of this provider requires Terraform 0.12 or later.

Usage Example

# Configure Terraform
terraform {
  required_providers {
    azuread = {
      source  = "hashicorp/azuread"
      version = "~> 2.7.0"

# Configure the Azure Active Directory Provider
provider "azuread" {

  # NOTE: Environment Variables can also be used for Service Principal authentication
  # Terraform also supports authenticating via the Azure CLI too.
  # See official docs for more info:

  # client_id     = "..."
  # client_secret = "..."
  # tenant_id     = "..."

# Retrieve domain information
data "azuread_domains" "example" {
  only_initial = true

# Create an application
resource "azuread_application" "example" {
  name = "ExampleApp"

# Create a service principal
resource "azuread_service_principal" "example" {
  application_id = azuread_application.example.application_id

# Create a user
resource "azuread_user" "example" {
  user_principal_name = "ExampleUser@${}"
  display_name        = "Example User"
  password            = "..."

Further usage documentation is available on the Terraform website.

Developer Requirements

  • Terraform 0.12.x or later
  • Go 1.16.x (to build the provider plugin)

If you're building on Windows, you will also need:

For GNU32 Make, make sure its bin path is added to your PATH environment variable.

For Git Bash for Windows, at the step of "Adjusting your PATH environment", please choose "Use Git and optional Unix tools from Windows Command Prompt".

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.16+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

Clone the repository to: $GOPATH/src/

$ mkdir -p $GOPATH/src/; cd $GOPATH/src/
$ git clone

Change to the clone directory and run make tools to install the dependent tooling needed to test and build the provider.

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make tools
$ make build
$ $GOPATH/bin/terraform-provider-azuread

To compile the provider for attached debugging run make debug.

$ make debug
Provider started. To attach Terraform CLI, set the TF_REATTACH_PROVIDERS environment variable with the following:

See the documentation for attaching a debugger.

In order to test the provider, you can simply run make test.

$ make test

The majority of tests in the provider are Acceptance Tests - which provisions real resources in Azure. It's possible to run the entire acceptance test suite by running make testacc - however it's likely you'll want to run a subset, which you can do using a prefix, by running:

make testacc TESTARGS='-run=TestAccApplication'

The following ENV variables must be set in your shell prior to running acceptance tests:


NOTE: Acceptance tests create real resources, and may cost money to run.