Active Directory

These modules allow you to connect Make to Azure Active Directory (Azure AD), the cloud-based identity and access management service.

With Active Directory modules you can create, monitor, and manage all your users and groups in your Active Directory account.

To get started with Active Directory, create an account at aad.portal.azure.com.

Connecting Active Directory to Make

  1. Log in to your Active Directory account.

  2. Go to your Make scenario and select the Active Directory module you want to use.

  3. Under Connection, click Add.

  4. Give your new connection a name.

  5. Click Save.

You have successfully established the connection.

Users

Retrieves a list of users.

Connection

Establish a connection to your Active Directory account.

Expand

Used to include the expanded resource or collection referenced by a single relationship (navigation property) in your results. Only one relationship can be expanded in a single request. For example: memberOf or transitiveMemberOf.

Filter

Used to retrieve just a subset of a collection. Can also be used to retrieve relationships like memberOf and transitiveMemberOf. For example, find all users whose display name starts with the letter 'J': startsWith(displayName,'J'). Supports the OData system query language.

Order by

Specifies the sort order of the items returned. The default order is ascending order. For example: displayName desc.

Search

Restricts the results of a request to match a search criterion. For example: "description:One" AND ("displayName:Video" OR "displayName:Drive"). Supports OData system query language and $search query parameters.

Select

Returns a set of properties that are different than the default set. With select, you can specify a subset or a superset of the default properties. For example: id,displayName.

Limit

Enter the maximum number of users Make returns during one scenario execution cycle.

Creates a new user.

Connection

Establish a connection to your Active Directory account.

Account Enabled

Select whether or not the account is enabled.

Display Name

Enter the name to display in the address book for the user.

On Premises Immutable ID

Only needs to be specified when creating a new user account if you are using a federated domain for the User Principal Name.

Mail Nickname

Enter the mail alias for the user.

User Principal Name

It's an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains.

Password Profile

Password

The password must satisfy minimum requirements as specified by the user’s password policies property. By default, a strong password is required.

Force Change Password

Select whether to force change the password.

Force Change Password With MFA

Select whether to force change the password with multifactor authentication.

Retrieves a specific user.

Connection

Establish a connection to your Active Directory account.

User ID or Principal Name

Enter the ID or name of the user you want to retrieve.

Retrieves the list of groups memberships for a specific user.

Connection

Establish a connection to your Active Directory account.

User ID or Principal Name

Enter the ID or name of the user you want to retrieve membership information for.

Security Enabled Only

Yes to specify that only security groups that the entity is a member of should be returned; No to specify that all groups and directory roles that the entity is a member of should be returned.

Updates a user's information.

Connection

Establish a connection to your Active Directory account.

User ID or Principal Name

Enter the ID or name of the user you want to update.

Account Enabled

Select whether or not the account is enabled.

Given Name

Enter the given name (first name) of the user.

Surname

Enter the user's surname (family name or last name).

Display Name

Enter the name to display in the address book for the user.

Mobile Phone

Enter the primary cellular telephone number for the user.

Business Phones

Enter the telephone numbers for the user.

Mail

Enter the SMTP address for the user, for example, jeff@contoso.onmicrosoft.com.

Mail Nickname

Enter the mail alias for the user. This property must be specified when a user is created.

Other Mails

Enter any additional email addresses for the user; for example: ["bob@contoso.com", "Robert@fabrikam.com"].

Company Name

Enter the company name which the user is associated.

Street Address

Enter the street address of the user's place of business.

City

Enter the city in which the user is located.

Postal Code

Enter the postal code for the user's postal address.

State

Enter the state or province in the user's address.

Country

Enter the country/region in which the user is located.

About Me

Enter any text for the user to describe themselves.

Birthday

Enter the birthday of the user. See the list of supported date formats.

My Site

Enter the URL for the user's personal site.

Past Projects

A list for the user to enumerate their past projects.

Interests

A list for the user to describe their interests.

Schools

A list for the user to enumerate the schools they have attended.

Skills

A list for the user to enumerate their skills.

Preferred Language

Enter the preferred language for the user. Should follow ISO 639-1 Code; for example en-US.

Age Group

Select the age group of the user.

Consent Provided For Minor

Select whether consent has been obtained for minors.

Job Title

Enter the user’s job title.

Employee Type

Enter the employee type.

Employee ID

Enter the employee identifier assigned to the user by the organization.

Employee Hire Date

Enter the hire date of the user. See the list of supported date formats.

Department

Enter the name for the department in which the user works.

Office Location

Enter the office location in the user's place of business.

Responsibilities

A list for the user to enumerate their responsibilities.

On Premises Immutable ID

Only needs to be specified when creating a new user account if you are using a federated domain for the User Principal Name.

Password Policies

This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword.

Password Profile

Password

The password must satisfy minimum requirements as specified by the user’s password policies property. By default, a strong password is required.

Force Change Password

Select whether to force change the password.

Force Change Password With MFA

Select whether to force change the password with multifactor authentication.

Usage Location

A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: US, JP, and GB.

User Principal Name

It's an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains.

User Type

Enter the user type.

Deletes a specific user.

Connection

Establish a connection to your Active Directory account.

User ID or Principal Name

Enter the ID or name of the user you want to delete.

Groups

Retrieves a list of groups.

Connection

Establish a connection to your Active Directory account.

Expand

Used to include the expanded resource or collection referenced by a single relationship (navigation property) in your results. Only one relationship can be expanded in a single request. For example: members.

Filter

Used to retrieve just a subset of a collection. Can also be used to retrieve relationships like members and transitiveMembers. For example, find all groups whose display name starts with the letter 'J': startsWith(displayName,'J'). Supports the OData system query language.

Order by

Specifies the sort order of the items returned. The default order is ascending order. For example: displayName desc.

Search

Restricts the results of a request to match a search criterion. For example: "description:One" AND ("displayName:Video" OR "displayName:Drive"). Supports OData system query language and $search query parameters.

Select

Returns a set of properties that are different than the default set. With select, you can specify a subset or a superset of the default properties. For example: id,displayName.

Limit

Enter the maximum number of groups Make returns during one scenario execution cycle.

Retrieves information about a specific group.

Connection

Establish a connection to your Active Directory account.

Group ID

Enter the ID of the group you want to retrieve.

Allows you to add multiple members to a group.

Connection

Establish a connection to your Active Directory account.

Group ID

Enter the ID of the group you want to add members to.

Members IDs

Add the IDs or names of users you want to add to the group.

Removes a single member from a specific group.

Connection

Establish a connection to your Active Directory account.

Group ID

Enter the ID of the group you want to remove a member from.

Members ID

Select the ID of the member you want to remove from the group.

Other

Performs an arbitrary authorized API call.

Note

For the list of available endpoints, refer to the Active Directory API documentation.

Example of use - List users

The following API call returns a list of all the users in your Active Directory account.

URL: /v1.0/users

Method: GET

active_directory_1.png

Matches of the search can be found in the module's Output under Bundle > Body > value. Our example returned 6 users:

active_directory_2.png

Retrieves user information for the signed-in user.