Office 365: Create Security Group
Description
Office 365: Create Security Group plugin step creates a Security Group.
Permissions:
Following permissions are required to create a security group in Office 365:
| Permission type | Permission (from least to most privileged) |
|---|---|
| Application | Group.Create, Group.ReadWrite.All, Directory.ReadWrite.All |
References:
- https://docs.microsoft.com/en-us/graph/api/group-post-groups?view=graph-rest-1.0&tabs=cs
- https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0#security-groups-and-mail-enabled-security-groups
Configurations
| No. | Field Name | Description |
|---|---|---|
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | For details about app registration, see O365 App Registration, Authentication, and Permissions in Azure AD | |
| 2 | Tenant ID | Provide a valid Tenant ID of Microsoft Account. The data type is string. This field is mandatory. |
| 3 | Client ID | Client ID of the Application created in Microsoft Account. The data type is string. This field is mandatory. |
| Client Secret | ||
| 4 | Accept Value as variable/static | Leave checkbox unchecked to accept Client Secret value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Client Secret field to appear as Text box. |
| 5 | Client Secret | Specify the Client Secret generated in Microsoft Account. Client Secret is entered using a widget. The widget handles both Text (static value or environment variable) and Combo (drop down containing values from previous steps). If checkbox above is enabled Client Secret field appears as a Text box and accepts static or variable values. Else if checkbox above is disabled Client Secret field appears as a drop down to select fields from previous steps. The data type is secure string. This field is mandatory. |
| 6 | Button: Test Connection | Test connection with Client ID and Client Secret provided. Verifies whether the connection is established or not. Note: For the purpose of verification fields coming from previous steps are not allowed since field values can only be accessed when workflow is in running state. Static values and environment variables are allowed. |
| Input Tab | ||
| Input Fields | ||
| 1 | Group Name | Specify the name to display in the address book for the group. The data type is String. This field is mandatory. |
| 2 | Mail Nickname | Specify the mail alias for the group. The data type is String. This field is mandatory. |
| 3 | Group Description | Specify the description of the group. The data type is String. This field is optional. |
| 4 | Group Owner | Specify the Group Owner’s name. The data type is String. This field is optional. |
| Output Tab | ||
| Output Field: | ||
| 1 | Group ID | Specify an Output field to hold the ID of the Security Group created. The data type is String. This field is mandatory. Note: After successful execution, it takes some time for the created group to get reflected on the instance. |