Azure Active Directory

Learn how to connect Engini to Azure Active Directory.
With the Azure AD activities in Engini, you can manage users and groups, including creating, updating, deleting, and retrieving user and group details, as well as managing user licenses.

Getting Started with Azure AD #

Prerequisites #

• A Microsoft account.

Add a connection to Azure AD in Engini #

1. Enter your Engini account at https://app.engini.io.
2. Navigate to Connections page by clicking on the Connections on the left sidebar or by clicking here.
3. Click on the Add connection option located at the topbar.
   
4. Choose Azure AD option from the available applications.
   
5. Enter the following details in the “Add Connection” form:
   
   • Connection name
   • Fields automatically populated post connecting to a Microsoft account include:
     • Email: Used as the primary email address associated with the account.
     • Access Token: A token for authorization to access Microsoft services.
     • Refresh Token: A token used to obtain a new access token when the current one expires.
   • Click on the “Microsoft Signin” button.
   • Sign into your Microsoft account.
   • Click on the save button to save the connection.

Triggers #

Check for Users Created #

The trigger listens for new users at scheduled intervals as defined.

1. Choose the Azure software.
2. Click on the “Check for Users Created” trigger.
3. Starting (UTC)
   Select the start date and time for the scheduled trigger.
4. Recur every
   Choose the time interval for triggering and checking emails. The minimum time interval is 15 minutes.
5. Add time frame
   You can specify a time frame during which the trigger will operate.
   1. Click on “Add time frame” button.
   2. Select a specific time frame to activate the trigger.
      For example, every 15 minutes from 8 AM to 5 PM.
      
6. Select a condition if necessary:
   
   1. Click on “Add conditions” button.
   2. To select an item from the list, click the small arrow.
   3. Choose the field on which you want to apply the filter from the drop-down.
   4. Select the condition.
   5. Choose the value for which you want the condition to be met.

Actions #

Get Users #

Get all users.

1. Sorting
   
   1. Click on the “add sorting” button.
   2. Choose from the drop down the field you want to sort by.
   3. Choose the sorting option: descending or ascending. You can define a multi sort by adding more than one field to the sort. Use the arrows on the right to select the field that will be used as the primary sort, secondary, etc.
2. Filter
   
   1. Click on “Add Filter” button.
   2. To select an item from the list, click the small arrow.
   3. Choose the field on which you want to apply the filter from the drop-down.
   4. Select the condition.
   5. Choose the value for which you want the condition to be met.
3. Top N 
   You can set the maximum number of records Engini will return for the object you chose (default = all records).

Get User #

By using this action, you can get one user.

• Enter a user id in the ‘User Id’ field.

Get User License Details #

By using this action, you can get the user’s license details.

• Enter a user id or user email in the field in order to get his license details.

Get Group #

By using this action, you can get a specific group.

• Enter a group id in “Id” field in order to get information about the group.

Get Groups #

By using this action, you can get all groups.

1. Sorting– as explained in Get Users activity
2. Filter – as explained in Get Users activity
3. Top N 
   You can set the maximum number of records Engini will return for the object you chose (default = all records).

Get Group Members #

By using this action, you can retrieve all group members.

1. Group Id
   Enter a group Id for which you want to retrieve the members.
2. Sorting– as explained in Get Users activity.
3. Filter – as explained in Get Users activity.
4. Top N 
   You can set the maximum number of records Engini will return for the object you chose (default = all records).

Get Subscribed SKUs #

Each account in Azure AD has a list of associated services. Each Azure service or resource can have multiple SKUs, which determine the features and pricing for that particular service.
To get information about those SKUs, add this activity.

Create User #

By using this action, you can add a user to your Azure system.

1. accountEnabled
   Choose whether the user account is enabled or disabled.
   • False-The account is disabled and the user cannot sign in or access resources.
   • True-The account is enabled and the user can sign in and access resources.
2. displayName
   Choose the name of the user as it will appear in the Azure system.
3. mailNickname
   Choose the mailNickname for the account. It should match the username part of the User Principal Name (UPN) or the sAMAccountName.
   For example, if the UPN is Dana.Levi@domain.com, then the mailNickname should be Dana.Levi.
4. PasswordProfile- forceChangePasswordNextSignIn
   Select if the user is required to change their password at their next sign-in.
   • False-The user will not be required to change their password on their next sign-in.
   • True-The user will be required to change their password upon their next sign-in.
5. PasswordProfile-password
   Specify a password for the user.
6. userPrincipalName
   Add a User Principal Name (UPN).It is the username combined with the domain in an email address format.
7. Add Field
   1. By clicking the “Add field” button, you can choose how to fill in the various fields of the object. You can add one field to the action or more.
   2. Choose from the drop down the field you want to fill.
   3. Click on the empty field to the right of the drop down to be shown the tooltip with all the options you can use to fill the field.
   4. You can populate the fields in one of the following options:
      • Static value – number / string. when using strings, you need to surround them with single quotes (‘).
      • Property value from a previous activity (Using the tooltip that opens when clicking on the field).
      • Expression – using functions and/or Previous activity properties and/or static values (Using the tooltip that opens when clicking on the field). 
   5. Repeat steps 1-4 for all the fields you want to populate.

Create Group #

By using this action, you can add a group to your Azure system.

1. displayName
   Give the group a miningful name.
2. mailEnabled
   Choose whether the group can receive and send emailis.
   • False-The group is not mail-enabled, it does not have an associated email address.
   • True-the group is mail-enabled. It has an associated email address and can be used to send and receive emails.
3. mailNickname
   Select a unique email alias for the group for mail-enabled groups.
4. SecurityEnabled
   Choose if the group can be used to control access to resources such as files, folders, and applications.
   • False- The group is not a security group and is used for non-security purposes.
   • True- The group is a security group, it can be used to control access to resources such as files, folders, and applications.
     This is the default value.
5. Add Field
   Choose which group’s fields you want to add to the group and populate them with values as specified in the Create User activity.

Update User #

By using this action, you can update a user within your Azure system.

1. User Id
   Specify which user you want to update by selecting their ID.
2. Add Field
   Choose which user’s fields you want to update and populate them with new values as specified in the Create User activity.

Update Group #

By using this action, you can update a group within your Azure system.

1. Group Id
   Specify which group you want to update by selecting their ID.
2. Add Field
   Choose which group’s fields you want to update and populate them with new values as specified in the Create User activity.

Delete User #

By using this action, you can delete a user within your Azure system.

• User Id
  Enter the user ID of the user you want to delete in the ‘User Id’ field.

Delete Group #

By using this action, you can delete a group within your Azure system.

• Group Id
  Enter the group ID of the group you want to delete in the ‘Group Id’ field.

Remove Member from Group #

By using this action, you can delete a member from a group in your Azure system.

1. Group Id
   Enter the group ID that the member belongs to in order to delete the member from the group.
2. Member Id
   Enter the member ID of the user you want to delete from the group.

Remove User License #

By using this action, you can delete a user’s license in your Azure system.

1. User email or Id
   Enter the email address or Id of the user from whom you want to remove the licenses.
2. Licenses to Remove[]
   Add the licenses you want to remove from the user in the CreateArray() function.
   To learn more about functions, click here.

Assign User License #

By using this action, you can assign a license to a user in your Azure system.

1. User Id
   Enter the Id of the user to whom you want to assign the license.
2. Assigned Licenses[]
   Add the licenses you want to assign to the user in the CreateArray() function.
   To learn more about functions, click here.

Initialize Object Array #

This activity allows you to create and set up an array, a structured collection of objects, which can be used for various purposes throughout your workflow.

1. Variable name
   By default, the array is named ‘array,’ but you have the flexibility to rename it according to your specific use case.
2. Object Element Type
   Select the type of objects from the drop-down menu that will be stored in the array.

Map Object Array #

The map object array activity allows you to transform a data list that contains multiple pieces of data into a new data list based on the properties and values you choose.

1. Data List
   Choose a data list that you’ve obtained from previous activities in your workflow. This data list typically contains an array of objects that you want to process.
2. Object name
   Choose the object name. It can be assigned label or assigned licenses.
3. Add Field
   
   In the tooltip with all the options you can use to fill the field (as explained in the Create User activity).

Append Object to Array #

Appending an object to an array variable allows you to dynamically add new values to the end of the array.

1. Variable
   Choose the array to which you want to add an object.
2. Add Field
   Choose which fields you want to add and populate them with new values as specified in the Create User activity.