HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxUpdate

Important

This repository contains the connector and configuration code only. The implementer is responsible for acquiring the connection details such as username, password, certificate, etc. You might even need to sign a contract or agreement with the supplier before implementing this connector. Please contact the client's application manager to coordinate the connector requirements.

 

Table of contents

• HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxUpdate
  • Table of contents
  • Requirements
  • Remarks
  • Introduction
    • Description
    • ExchangeOnlineManagement module
    • Form Options
    • Task Actions
  • Connector Setup
    • Variable Library - User Defined Variables
  • Getting help
  • HelloID docs

Requirements

1. HelloID Environment:
   • Set up your HelloID environment.
2. Exchange Online PowerShell V3 module:
   • This HelloID Service Automation Delegated Form uses the Exchange Online PowerShell V3 module. A HelloID agent is required to import the Exchange Online module.
3. Entra ID Application Registration:
   • App registration with API permissions select APIs my organization uses search for Office 365 Exchange Online. Select Application permissions:
     • Exchange.ManageAsApp
   • The following information for the app registration is needed in HelloID:
     • Application (client) ID
     • Directory (tenant) ID
     • Secret Value
4. Entra ID Role:
   • The Exchange Administrator should provide the required permissions for any task in Exchange Online PowerShell.
     • To assign the role(s) to your application, navigate to Roles and administrators.
     • Search and select Exchange Administrator click Add assignments. Select the app registration that you created in step 3.
     • Click Next, assignment type Active.

Remarks

• None at this time.

Introduction

Description

HelloID-Conn-SA-Full-Exchange-Online-SharedMailboxUpdate is a template designed for use with HelloID Service Automation (SA) Delegated Forms. It can be imported into HelloID and customized according to your requirements.

By using this delegated form, you can update a shared mailbox in Exchange Online. The following options are available:

1. Search and select the shared mailbox
2. Option to edit the shared mailbox name.
3. Option to edit the shared mailbox alias.
4. Option to edit the shared mailbox primarySmtpAddress.
5. A data source will validate the input in exchange online. If this is valid you can submit the form.
6. The task will update the shared mailbox

ExchangeOnlineManagement module

The ExchangeOnlineManagement module provide a set of commands to interact with Exchange Online. The commands used are listed in the table below.

Endpoint	Description
Get-User	Required for Get-Mailbox / Set-Mailbox
Get-Mailbox	To retrieve and validate the input in Exchange Online
Set-Mailbox	To update the shared mailbox in Exchange Online

Form Options

The following options are available in the form:

1. Search and select shared mailbox:
   • Search and select the shared mailbox that needs to be updated.
2. Edit and validate data:
   • Edit one or more of the following properties: name, alias or primairysmtpaddress. The Powershell data source will validate the input in exchange online.

Task Actions

The following actions will be performed after submitting the form:

1. Retrieve the shared mailbox in exchange online:
   • The Get-Mailbox command will be used to get the current Aliases
2. Updating the shared mailbox in exchange online:
   • The Set-Mailbox command will be used to update the shared mailbox

Connector Setup

Variable Library - User Defined Variables

The following user-defined variables are used by the connector. Ensure that you check and set the correct values required to connect to the API.

Setting	Description
EntraOrganization	The name of the organization to connect to and where the Entra ID App Registration exists.
EntraTenantId	The ID to the Tenant in Microsoft Entra ID
EntraAppId	The ID to the App Registration in Microsoft Entra ID
EntraAppSecret	The Client Secret to the App Registration in Microsoft Entra ID

Getting help

Tip

For more information on Delegated Forms, please refer to our documentation pages.

Tip

 If you need help, feel free to ask questions on our forum.

HelloID docs

The official HelloID documentation can be found at: https://docs.helloid.com/