Integrations
CYRISMA supports integrations with cloud services such as Google Workspace and Microsoft Office 365 for performing cloud-based scans of hosted email and files. These integrations require setting up API credentials. Below is an overview of the integrations setup process, including credential fields and how to manage the integrations.
Written by Noah Garland
Updated at December 6th, 2024
- User Manual
- Agents
- The Cyber Risk Assessment Process
- API Documents
- General Questions and Troubleshooting
- The Cyber Risk Assessment Process (Video Tutorials)
- Sales and Prospecting Articles
- CYRISMA Partner Portal Access
- Glossary
- CYRISMA Change Log
- Support Ticket SLA
- Onboarding Framework
- PSA Integrations
- Billing Questions
- Self Onboarding Guide
Table of Contents
Setting Up Integrations
-
Navigate to Integrations:
- From the main menu, select Admin → Integrations.
- You will see options to configure credentials for Office 365 or Google.
Office 365 Integration
To configure Microsoft Office 365 API credentials:
Fields to Configure:
- Application (Client) ID: The unique ID for the application in the Azure portal.
- Publisher Domain: The verified domain within your Azure Active Directory.
- MS Client Secret Value: The secret key generated during app registration.
Verification and Submission:
- Once the details are filled in, click Verify Credentials to confirm the validity of the configuration.
- Click Submit to save the credentials for future scans.
Additional Notes:
- Obtain the required values from the App Registration Permission process within your Azure portal.
Follow this step-by-step Office 365 Set Up Process Guide to integrate Microsoft Office 365.
Google Workspace Integration
To configure Google Workspace API credentials:
Fields to Configure:
- Project ID: The Google Cloud project ID for the integration.
- Private Key: The private key for authentication (sensitive information is protected).
- Delegated Service Email: The service account email generated for the API project.
- Domain Service Email: The domain admin email address.
Google Security File:
- Upload the Google JSON Security File provided during API configuration.
Verification and Submission:
- Click Verify Credentials to validate the Google configuration.
- Click Submit to save the credentials for future scans.
Additional Notes:
- Follow the steps in the Google Set Up Process Guide to correctly configure App Registration and permissions in Google Admin.
General Information
- Credential Verification: Ensure all fields are accurately filled before verifying credentials to avoid errors.