9affbe80e6
* Rename folders * Update readme for folder rename * Updated readme with distinction Added a disctinction for open sourcing instructions for certified vs custom connectors * Fix Minor Typo Co-authored-by: Bob Zhang <54606291+bezhan-msft@users.noreply.github.com> |
||
---|---|---|
.. | ||
README.md | ||
apiDefinition.swagger.json | ||
apiProperties.json |
README.md
NOTE
This is a sample connector. The connector is provided here with the intent to illustrate certain features and functionality around connectors.
Office365 Groups Connector (Sample)
Office 365 Groups lets you manage group membership and calendar events in your organization using your Office 365 account. You can perform various actions such as get group roster, add or remove members and create group events.
Public Connector: https://docs.microsoft.com/en-us/Connectors/office365groups/
Setup
- Enable authentication in Azure Active Directory
to setup authentication for your custom connector via AAD. Keep note of the
AAD application ID
andYour-Base64-Key
. - Replace
aad_application_id
in apiProperties.json file with yourAAD application ID
. - Use CLI tool
paconn
to create a new custom connector. EnterYour-Base64-Key
when prompted for the "OAuth2 client secret". - Set the reply URL in Azure, you can find the redirect URL in the security page of your custom connector.
Supported Actions
The following actions are supported:
-
List all groups
: List all the groups available in an organization. -
List groups that I am a member of
: List all groups that you are a member of. -
List group members
: List all members in the given group and their details such as name, title, email, etc. -
Join group
: Add yourself to a group. -
Remove member from group
: Remove a member from a group. -
Create group
: Create a new group. -
Delete group
: Delete a group.
Please note that each of these operations would succeed only if you have sufficient permissions to execute that operation on the group.