PowerPlatformConnectors/custom-connectors/Office365Groups
Doug Elliott 9affbe80e6
Rename folders (#138)
* 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>
2020-02-18 17:51:25 -08:00
..
README.md Rename folders (#138) 2020-02-18 17:51:25 -08:00
apiDefinition.swagger.json Rename folders (#138) 2020-02-18 17:51:25 -08:00
apiProperties.json Rename folders (#138) 2020-02-18 17:51:25 -08:00

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

  1. Enable authentication in Azure Active Directory to setup authentication for your custom connector via AAD. Keep note of the AAD application ID and Your-Base64-Key.
  2. Replace aad_application_id in apiProperties.json file with your AAD application ID.
  3. Use CLI tool paconn to create a new custom connector. Enter Your-Base64-Key when prompted for the "OAuth2 client secret".
  4. 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.