Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
  • CyberCNS supports integrations for different purposes. Office 365 Email Integration being one of them, helps to send outbound emails for notification purposes.

  • For the reporting tool to operate properly, it is advised to use a licenced user's email address as the Send From address. There might be restrictions or configurations when using a shared mailbox that could prevent the reporting tool from producing reports.

Set up Office 365 Email Integration

Info

This screen is likely to change as we go on adding more integrations.

...

  • Input Email Credentials as requested. Credential Name, SMTP Host, SMTP Port, SMTP Username, SMTP Password, From Address, & Test Address details are required to configure successfully.

Enter Credentials

  1. Enter Credential Name: Choose a name of your choice for the set of credentials to be added.

  2. Enter Email For Receiving Test Email: Enter an email address for receiving the test email for the credentials to be added.

  3. Enter Client ID: Enter a Client ID for the credentials to be added.

  4. Enter Client Secret: Enter a Client Secret for the credentials to be added.

  5. Enter Tenant ID: Enter a Tenant ID for the credentials to be added.

  6. Enter the Email Address the email to be sent from: Enter an email address for the email to be sent from.

  7. Enter the Email Address For Sending Reply To: Enter an email address to test the email address to be replied to.

  8. Select Company: To use these credentials to send outbound emails for any company, please select Associated Company from the dropdown.

...

Follow the below screenshots to fetch the details of Client ID, Client Secret, and Tenant ID:

  • In the Microsoft Azure portal, navigate Login to https://portal.azure.com/ using MFA Enabled Global Administrator Role to get Client ID, Secret ID, Tenant ID and set permissions.

  • Navigate to App RegistrationsNew registration.

...

  • In the Register, an application page, enter a Name of your choice for app registration.

  • Please select Account types as Single tenant (shown below). As supported by Microsoft, we need to select Single Tenant.

...

  • Navigate to API Permissions -> click on + to Add a permission and click on Grant admin consent.

  • Add API Permissions from both Applications and Delegated permissions.

...

  • As depicted in the below image, Grant admin consent permission for MailSend, MailSendShared, and UserRead.

...

  • Navigate to the Overview section for the registered application.

  • Copy the Application (Client) ID and Directory(tenant) ID from here to be provided into the CyberCNS portal.

...

Default Template

  • When the credentials are added, an option to add the default template is seen.

  • Instead of selecting each time for ticket creation in the integration action, we can add a default template here for a particular integration.

...

  • The next step is to map local companies in CyberCNS to Email Integration companies corresponding to the selected domain.

Company Mapping

Info

Multiple companies can be mapped using company mapping.

...

  • Here a set of Events is to be set to get notified for. Those events are categorized as Agent, Company, Asset, Ports, Remediation, Vulnerability, Azureerror, AD Audit, Azure AD Audit, and Unquoted Service Path. Every category will have certain events which that can be set.

  • Enter the Event Name and select the category and an Event/s as required.

...

  • Once the event is set to default, under Is Default column, the status Yes can be seen.

...

Integration Profile

Info

Users will be able to set Alerting rules from integrations right away for conditions listed under it.

...

  • There is an option to Edit, Delete and Set as default under the Integration Rules using the Action column. The listed Integration Rule can be edited and deleted if needed

...

  • For setting the newly created Event as the default, select the option Set as Default.

...

  • To confirm the Set as a default action, select Yes or No in the confirmation dialogue box.

...

Manage Company Mapping

  • Click on Manage Company Mapping.

  • Choose Office 365 Email Credentials from the dropdown and click on + Add to add Integration Mapping for specific companies.

  • In New Company Mapping, choose the Office 365 Email Credential which is listed. (These are to be added under the Integration> Credentials section for Office 365 Email).

...

  • In case the local company is already created in CyberCNS and is to be mapped with ConnectWise company, then select Map Existing Company to Office 365 Email company and click on Next.

  • As shown in the below image, select the Local company( CyberCNS) by using a dropdown or with the search bar as per the requirement so it will map the companies accordingly.

  • Please choose/select the Pause Ticket Creation option only if no notifications are required using this integration and click Add.

...

  • Once the Create Office365 Email Alert is enabled, select the Event Set, and the Integration Profile, and click on '+' to add the record.

  • Delete the Integration profile in case not required using the bin icon as shown below.

...

  • Selected companies are shown in the image below, along with details such as Existing Company Name, Company Name, Event Set, Integration Profile, Pause Ticket Creation, and Mapped Date.

  • Company Mapping info can be copied over to the other company using Copy Settings. This option is available under action column.

  • Select the Copy Settings from the company whose information to be copied.

...

  • To copy the selected settings, select the desired company mappings and click on Update. This will copy the event set, integration profile, and ticket creation fields from the source company mapping to the selected target company mappings.

...

  • Using the Action column can edit or delete the integration mapping. Any mapping can be edited or deleted, whenever necessary.

...