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 enter your engini account at https //app engini io navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the add connection option located at the topbar choose azure ad option from the available applications enter the following details in the “add connection” form connection name enter a unique and descriptive name for this connection this name will help you easily identify and manage your azure active directory connection within your system 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 sign in with microsotf click on the “microsoft signin” button sign into your microsoft account save settings 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 choose the azure software click on the “check for users created” trigger starting (utc) select the start date and time for the scheduled trigger recur every choose the time interval for triggering and checking emails the minimum time interval is 15 minutes add time frame you can specify a time frame during which the trigger will operate click on “add time frame” button select a specific time frame to activate the trigger for example, every 15 minutes from 8 am to 5 pm output fields define which fields are returned by the trigger and passed to the next modules in the scenario selecting only the required fields reduces data load, improves performance, and simplifies filtering and conditions later on add sorting click on the “add sorting” button choose from the drop down the field you want to sort by 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 add conditions if you want the trigger “check for users messages” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field 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) repeat steps a d for all the fields you want to populate actions get users get all users output fields define which fields are returned by the trigger and passed to the next modules in the scenario selecting only the required fields reduces data load, improves performance, and simplifies filtering and conditions later on top n you can set the maximum number of records engini will return for the object you chose (default = all records) add sorting click on the “add sorting” button choose from the drop down the field you want to sort by 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 add conditions if you want the action “get users” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field 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) repeat steps a d for all the fields you want to populate get user by using this action, you can get one user user id 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 user email or id 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 id enter a group id in “id” field in order to get information about the group output fields define which fields are returned by the trigger and passed to the next modules in the scenario selecting only the required fields reduces data load, improves performance, and simplifies filtering and conditions later on get groups by using this action, you can get all groups output fields define which fields are returned by the trigger and passed to the next modules in the scenario selecting only the required fields reduces data load, improves performance, and simplifies filtering and conditions later on top n you can set the maximum number of records engini will return for the object you chose (default = all records) add sorting click on the “add sorting” button choose from the drop down the field you want to sort by 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 add conditions if you want the action “get groups” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field 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) repeat steps a d for all the fields you want to populate get group members by using this action, you can retrieve all group members output fields define which fields are returned by the trigger and passed to the next modules in the scenario selecting only the required fields reduces data load, improves performance, and simplifies filtering and conditions later on top n you can set the maximum number of records engini will return for the object you chose (default = all records) add sorting click on the “add sorting” button choose from the drop down the field you want to sort by 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 add conditions if you want the action “get group member” to be activated only under a certain condition, click on the “add condition” button by choosing to add a condition, the workflow will only work if the condition or the number of conditions you added are met follow the next steps to add conditions select from the drop down the field you want to add the condition on select the condition you want the record to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field 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) repeat steps a d for all the fields you want to populate 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 account enabled 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 display name choose the name of the user as it will appear in the azure system mail nickname 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 password profile force change password next sign in 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 password profile password specify a password for the user user principal name add a user principal name (upn) it is the username combined with the domain in an email address format add field 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 choose from the drop down the field you want to fill 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 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) 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 display name give the group a miningful name mail enabled 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 mail nickname select a unique email alias for the group for mail enabled groups security enabled 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 add field 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 choose from the drop down the field you want to fill 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 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) repeat steps 1 4 for all the fields you want to populate update user by using this action, you can update a user within your azure system user id specify which user you want to update by selecting their id add field 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 choose from the drop down the field you want to fill 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 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) repeat steps 1 4 for all the fields you want to populate update group by using this action, you can update a group within your azure system group id specify which group you want to update by selecting their id add field 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 choose from the drop down the field you want to fill 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 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) repeat steps 1 4 for all the fields you want to populate 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 group id enter the group id that the member belongs to in order to delete the member from the group 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 user email or id enter the email address or id of the user from whom you want to remove the licenses 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 user id enter the id of the user to whom you want to assign the license assigned licenses \[] add the licenses you want to assign to the user in the createarray() function to learn more about functions, https //engini io/help/tools/engini functions/ initialize object array this activity initializes an object array in azure active directory and stores a single structured entry based on the selected object type (azure active directory, assigned licenses) variable name enter the name of the variable that will hold the initialized object array this name will be used throughout the workflow whenever you refer to this object array object element typ e this field defines the type of data the array will store such as, azure active directory, assigned licenses and more the selected type determines the structure of the array and its use in subsequent actions fields by clicking ‘add field,’ you can select the fields you want to include in the selected object the available fields will vary depending on the object type you selected in step 2 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 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 object name choose the object name it can be assigned label or assigned licenses 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 variable choose the array to which you want to add an object add field choose which fields you want to add and populate them with new values as specified in the create user activity