|
|
| (9 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| | + | This document can now be found at its new location in the [https://docs.hornbill.com/ibridge-packages/welcome Hornbill Document Library]. |
| | | | |
| − | <div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
| + | [[file:hornbill-document-library.png|iBridge Package Reference|link=https://docs.hornbill.com/ibridge-packages/welcome]] |
| − | __NOTOC__[[Main Page|Home]] > [[Integration]] > [[Business Process Automation & Orchestration]] > [[Hornbill iBridge]] > Microsoft
| + | [[Category:HDOC]] |
| − | </div>
| |
| − | {|style="width: 100%"
| |
| − | |- valign="top"
| |
| − | |style="width:73%"|
| |
| − | [[File:ibridge_Microsoft.png|ibridge_Microsoft.png]]
| |
| − | ==Introduction==
| |
| − | Microsoft develops, manufactures, licenses, supports and sells computer software, consumer electronics, personal computers, and services
| |
| − | | |
| − | Create and update Users, Groups and Mailboxes in Azure and Office 365 as well as invoke Flows in Microsoft
| |
| − | | |
| − | Microsoft is a [[Hornbill_iBridge#Premium_Integrations|Premium Integration]] [[File:Green_Dollar.png|12px|link=https://wiki.hornbill.com/index.php/Hornbill_iBridge#Premium_Integrations|Premium Integration]]
| |
| − | |style="width:5%"|
| |
| − | |
| |
| − | |style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
| |
| − | | |
| − | == Related Articles ==
| |
| − | :* [[Hornbill iBridge]]
| |
| − | :* [[Hornbill_iBridge#Premium_Integrations|Premium Integrations]]
| |
| − | :* [[Hornbill_KeySafe|KeySafe]]
| |
| − | :* [[Integration Call]]
| |
| − | :* [[Business_Process_Designer|Business Process Designer]]
| |
| − | |}
| |
| − | | |
| − | ==KeySafe Configuration==
| |
| − | [[File:Keysafe_Microsoft.png|300px|right]]
| |
| − | In order to integrate with Microsoft products, you will first need to configure, and securely store the authentication credentials for the Microsoft instance and Accounts you want to use with the Hornbill App.
| |
| − | | |
| − | Integrations with Microsoft cloud products (including the Azure Groups and Users operations) require the use of the '''Microsoft''' KeySafe key type.
| |
| − | | |
| − | Configure your '''Microsoft''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''' in order to use the Microsoft options.
| |
| − | | |
| − | In the admin console > System > Security > KeySafe
| |
| − | | |
| − | * Select on '''+''' and choose '''Microsoft'''
| |
| − | * Give the Microsoft KeySafe a Title (this is the name/identifier for the Microsoft account as you will see it when using the Integration Call node in your business process)
| |
| − | * Optionally add a description
| |
| − | * Select '''Create Key''' to save
| |
| − | | |
| − | Once the Key is created, you will need to connect to Microsoft and your account, in order to authorize the Hornbill App to perform the listed Microsoft options.
| |
| − | | |
| − | Select Connect
| |
| − | You will be redirected to Microsoft in a popup window, where you will be required to log in to your Microsoft account, and then you will be prompted to review the option you are authorising the Hornbill App to be allowed to perform with the chosen Microsoft account.
| |
| − | | |
| − | [[File:Information.png|14px|text-top|Information]] The Microsoft account you are using will need to have Microsoft '''Admin''' level permissions in order to perform the desired actions in Microsoft.
| |
| − | | |
| − | '''Managing Microsoft Configurations'''
| |
| − | | |
| − | * Use KeySafe to create, store and enable integrations with multiple Microsoft accounts for use in your business processes
| |
| − | * From the Keysafe List, select a Microsoft account, and use the '''Trash Can''' to delete it
| |
| − | :* Note, this will remove the rights of any existing Microsoft Integration Calls in your business processes, which are using the now deleted Microsoft Account, so you will need to edit your business processes accordingly.
| |
| − | | |
| − | ==Business Process==
| |
| − | ===Options (Methods)===
| |
| − | Once you have your Microsoft Account Authorised, you're all set to use it with the '''[[Integration Call]]''' in your business processes. The following options are now available for you to use with Microsoft:
| |
| − | | |
| − | '''Azure'''
| |
| − | * Groups
| |
| − | :* Add User to Group
| |
| − | :* Create Group
| |
| − | :* Delete Group
| |
| − | :* Get Owner - NOTE - where a Group has multiple owners, the details of the first owner returned by the Microsoft API will be returned by the Cloud Integration node
| |
| − | :* Remove User from Group
| |
| − | :* Reset unseen count
| |
| − | * Users
| |
| − | :* Create User
| |
| − | :* Delete User
| |
| − | :* Get User
| |
| − | :* Invite User
| |
| − | :* Password Reset
| |
| − | :* Update User
| |
| − | | |
| − | '''Flow'''
| |
| − | * Trigger Flow
| |
| − | | |
| − | '''Office 365'''
| |
| − | * Calendar
| |
| − | :* Create Calendar Event
| |
| − | :* Create Calendar
| |
| − | * Contact
| |
| − | :* Create Contact Entry
| |
| − | * Group
| |
| − | :* Create Calendar Entry
| |
| − | :* Delete Calendar Entry
| |
| − | * Mail
| |
| − | :* Create Mail Folder
| |
| − | :* Delete Mail Folder
| |
| − | :* Send Mail
| |
| − | | |
| − | '''Teams''' '''''DEPRECATED'''''
| |
| − | See [[Microsoft Teams]] for replacement Teams operations.
| |
| − | * Post to Channel - This integration will start a conversation on a Teams channel.
| |
| − | * Reply To Channel - This integration will reply to an existing conversation in a Teams channel.
| |
| − | | |
| − | Read more about using the '''[[Integration Call]]''' from the Related Articles section, and learn how to work with input and output parameters for each of the Microsoft options.
| |
| − | | |
| − | ==Example==
| |
| − | {{#ev:youtube|iuDRw1RNySo|350|right}}
| |
| − | | |
| − | In this example, we will see how it is possible to use multiple automation's across multiple cloud services to orchestrate repetitive tasks such as creating user accounts as part of your new starter / on-boarding process. In this example, we have predefined the authentication credentials in KeySafe for Microsoft Azure, SalesForce and Hornbill.
| |
| − | | |
| − | Through the business process designer, we can then use the Integration Call node several times, invoking the different automation options to allow us to take progressive capture and request variables to create a new user in Microsoft Azure, SalesForce and Hornbill
| |
| − | | |
| − | In this example we will also show the use of one of the Hornbill iBridge utilities for generating temporary passwords, configurable to conform to different password strength requirements, as well as look at automating the allocation of roles, and membership to groups in Hornbill to immediately take Serviced available to the user based on the groups subscription to different services.
| |
| − | | |
| − | [[Category:Integration]] | |
