Guides
Start typing to search…

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

  1. Open Azure Cloud Shell

  2. 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 contains Hyphen AI Inc with id 6875541.

3. Grant Hyphen application admin consent

  1. In the Azure Portal, search for Hyphen Dev in the search box and select the Hyphen Enterprise Application.
  2. Go to Security > Permissions.
  3. 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

  1. 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"]'
  2. 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

FieldTypeDescription
azureTenantIdstring (required)Azure Tenant ID provided by the user for authentication purposes.
namestringDisplay 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

FieldTypeDescription
groupIdstringUnique group ID in Azure, used for reference and future calls.
groupNamestringGroup name in Azure, used for display and future requests.
emailAddressstringGroup 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

FieldTypeDescription
userIdstringUnique user ID in Azure.
emailstringUnique user email in Azure.

Connection Input

Provide the Azure user email to connect to an existing User.

Updated 3 months ago