Initial Configuration Video
After you install the Cayosoft Administrator, when you run it for the first time, you need to complete the Initial Configuration wizard.
This wizard will walk you through the first-time setup. Some options are mandatory and you will be asked to provide the necessary information to continue. Other options are optional and may be skipped.
Each time you click Next the wizard will verify the settings you have provided and will prompt you if there is a problem.
Run Cayosoft Administrator after the first time setup - Initial Configuration wizard will appear:
Enter an email address where system notifications and alerts will be sent. Typically this is the email address of the person responsible for configuring Cayosoft Administrator.
If you install Client Tools only and Administrator Service is installed on another machine please see this article: How to install the Cayosoft Administrator Console on an Admin's Workstation – Cayosoft Help Center.
Select Extensions page
Depending on your environment, select the extensions that should be enabled.
|Active Directory only
|Active Directory and Exchange Server on-premise
|Active Directory, Exchange Server on-premise, and Microsoft 365 with Exchange Online and other cloud services
|Active Directory and Microsoft 365 with Exchange Online and other cloud services, no Exchange Server on-premises *
|Microsoft 365 with Exchange Online and other cloud services, no Active Directory or Exchange Server on-premises
* - Please, see KB20180323-1 article for additional configuration steps you might need to perform.
If you also need to manage objects in the Microsoft Skype server, check Active Directory and Microsoft Skype Server Extensions.
The next pages of the Initial Configuration Wizard will depend on selected extensions.
Note: You can also enable and configure any extension later in the Administrator Console.
Configure the Active Directory page
Active Directory extension settings are used in rules and actions related to Active Directory.
By default, all domains from the forest where Cayosoft Administrator is installed become enabled. All trusted domains are added as disabled. You can enable them if you need to.
Add... - add a new trusted or untrusted forest with its' domains for management.
Discover - add missing domains to the forests that are specified in the Managed Domains table.
Clear - remove all domains and forests that were added manually.
Active Directory domain credentials - to configure the Active Directory extension, specify credentials for the Active Directory domain administrator account. For more information, please see the Permissions required for the Active Directory management article.
Domain - check all domains that you need to manage.
DC - it is automatically selected during initial discovery, using the DC Auto selection method.
Alternative DC - you can set another DC to use in case the primary DC is identified as unavailable.
Credential - by default, the value is set to <Use Default Credentials>, which points to Active Directory domain credentials.
All managed domains are grouped by forests:
- All domains from the forest where the Cayosoft Administrator service is installed.
- All trusted\untrusted domains.
Click Configure to verify Forest Settings.
Default Country/region - depends on region settings. You can change it if you need to.
Configure the Microsoft 365 page
- MSOnline PowerShell for Azure Active Directory.
- Exchange Online PowerShell Module (EXO V3).
Microsoft 365 extension settings are used in rules and actions related to Microsoft 365.
Microsoft 365 credentials
To configure the Microsoft 365 extension, specify credentials for the Microsoft 365 account. You can create a new connection account or use an existing one.
Create a new connection account
- Click Create to run the wizard that will help you create a new Microsoft 365 account and provision it with the permissions required by the Cayosoft Administrator to manage your Microsoft 365 tenant.
When prompted to sign in to Microsoft 365 sign in with an account that has Global Admin or similar permissions.
- Click Next.
Click Grant to grant consent for the Connection Account to access your tenant information through the Microsoft 365 API.
Ensure the Microsoft 365 connection account is excluded from the Multi-Factor Authentication (MFA).
If you are enforcing MFA with Conditional Access Policies (CAP), please ensure the created connection account is excluded from these policies. For more information see Troubleshooting Conditional Access Policy enforcement on Microsoft 365 Connection Account – Cayosoft Help Center.
Use existing account
If you use an existing Microsoft 365 connection account you should ensure that this account meets the requirements listed on the product. For more information see Permissions required for AD and MS 365 accounts used by Cayosoft Administrator – Cayosoft Help Center.
- Specify the user account name.
- Specify the user account password.
- Click Ok.
Important: To continue the Initial Configuration Wizard, you must register the Azure application and gran consent for the Cayosoft Administrator Service. Otherwise, you will get the error. For details please see this article: How to register the application and grant consent for the Cayosoft Administrator Service to access the managed tenant.
- Click Register Azure Application.
- Click Grant. If you create a new connection account the consent will already be granted.
- Click Refresh to be sure that admin consent was granted
Microsoft 365 user name suffix
By default, this suffix is taken from the account specified in the Microsoft 365 credentials. You can change it if you need to. This suffix will be used as a default suffix in the new Microsoft 365 objects creation.
Default Usage Location
Default usage location depends on region settings. You can change it if you need to. This location will be used as a default in the new Microsoft 365 object creation.
You can select Azure Environment. If your tenant has another Azure environment parameter than the default value AzureCloud, you need to specify this value for a successful connection.
Troubleshooting Microsoft 365 connection issues
Configure the Microsoft Exchange page
Use these settings to configure the Microsoft Exchange extension:
Exchange Credentials - To configure Microsoft Exchange specify credentials for the Exchange Server administrator and connect the URL. For more information, please see the Permissions required for Exchange on-premises management article.
Connect URI - specify the Exchange server name.
Troubleshooting Exchange Server connection issues
Configure the Email Settings page
Starting from the 10.1 version Cayosoft Administrator can use one of two types of mail service to send messages and reports by email for rules and web actions: SMTP Server and Exchange Online.
For more details, see Configuration of Cayosoft Administrator Email Settings.
Email Settings for Exchange Online
Email Settings for SMTP
Configure the Microsoft Skype Server page
Microsoft Skype Server extension settings are used in rules and actions related to Skype Server.
Skype On-premises credentials - to configure the Microsoft Skype Server extension, specify credentials for the Skype Server Administrator account. This account should have Active Directory domain administrator permissions. For more information, please see the Permissions required for Active Directory management article.
Connect Uri - specify the Skype server name.
Maximum return results - the maximum number of users returned from the Skype server.
Default Registrar Pool - This pool is responsible for authenticating the user and for keeping track of his or her current status and location. Skype server registrar pool used in Cayosoft Administrator automation rules by default.
Default SipDomain - SIP domains are domains authorized to send and receive SIP traffic and are used when assigning SIP addresses to users.
Active Directory Domain Controller - FQDN of the Active Directory Domain Controller used to establish a connection to the Skype server.
|The Initial Configuration wizard has been improved for Azure AD SSO.
|Multi-forest management has been added.
|The managed Domains setting is modified. Forest Settings form is added.
|Initial Configuration Wizard is simplified.