Microsoft Office 365
Connect your Office 365 account to keep team membership synced for up-to-date document access, calendaring and distribution lists.
Setup
1. Create or sign into your Office 365 account
Sign in to Azure Portal
or
Create a new Azure Cloud account
2. Add Hyphen application
-
Execute the following command in the shell:
az ad sp create --id d0dee104-994b-4791-b7c8-8699727d45a4
- You should see in the response that the
verifiedPublisher
containsHyphen AI Inc
with id6875541
.
3. Grant Hyphen application admin consent
- In the Azure Portal, search for
Hyphen Dev
in the search box and select the Hyphen Enterprise Application. - Go to Security > Permissions.
- On the permissions page, click the Grant admin consent for Default Directory button.Doing so will grant these permissions:
- Directory.Read.All
- Group.ReadWrite.All
- User.Read.All
- Channel.Create
- ChannelMember.ReadWrite.All
- ChannelSettings.Read.All
- Team.ReadBasic.All
4. Copy and paste your object ID
- Go to Overview and copy the Object ID of the Hyphen application.
5. Add Enterprise Application tag
- In the Azure Cloud Shell, enter the following command to add the Enterprise Application tag to the Hyphen application:
az ad sp update --id ###OBJECT_ID### --set 'tags=["WindowsAzureActiveDirectoryIntegratedApp"]'
- Note: When browsing the Enterprise Applications Blade, you may need to remove the "Enterprise Applications" filter to see the Hyphen application.
6. Connect Tenant
- Fill out the form in the Microsoft Office 365 Setup Guide to connect the tenant with your organization ID.
Configuration
Field | Type | Description |
---|---|---|
azureTenantId | string (required) | Azure Tenant ID provided by the user for authentication purposes. |
name | string | Display name pulled during integration setup for reference purposes. |
Connections
Distribution List
Distribution list connections link to existing Azure Groups or create a new group if none is provided.
When creating a new group, the name will match the Hyphen Organization, Team, Project, App, or Project Environment name.
Configuration
Field | Type | Description |
---|---|---|
groupId | string | Unique group ID in Azure, used for reference and future calls. |
groupName | string | Group name in Azure, used for display and future requests. |
emailAddress | string | Group email address in Azure, used for display. |
Connection Input
Provide the Azure group ID to connect to an existing Group.
Verification
A verification email will be sent to the group email address to confirm ownership for existing groups.
Access
A Member connection will be added as a member when included in the group.
User
User connections link to existing Azure Users. If no input is provided, the member email will be used to search for an existing User.
Configuration
Field | Type | Description |
---|---|---|
userId | string | Unique user ID in Azure. |
email | string | Unique user email in Azure. |
Connection Input
Provide the Azure user email to connect to an existing User.
Updated 20 days ago