- 25 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
Lucidchart
- Updated on 25 Jun 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
Lucidchart allows users to collaborate on drawing, revising, and sharing charts and diagrams.
Types of Assets Fetched
This adapter fetches the following types of assets:
- Users
- Roles
- Licenses
- Application Settings
- SaaS Applications
Parameters
The parameters that you need to fill out will differ based on the capabilities in your Axonius platform. 'General' pertains to users with Cybersecurity Asset Management and/or SaaS Management capabilities.
General
Host Name or IP Address (required) - The hostname or IP address of the Lucidchart server that Axonius can communicate with via the Required Ports.
Client ID and Client Secret (required) - The Client ID and Client Secret for an account that has read access to the API.
One Time OAuth Access Code - The access coded generated in Lucidchart for gettting the refresh token and access token, for accounts that authorize with OAuth. For more information, see Getting the Access Code.
Verify SSL (required, default: false) - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
HTTPS Proxy (optional, default: empty) - Connect the adapter to a proxy instead of directly connecting it to the domain.
HTTPS Proxy User Name (optional, default: empty) - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.
HTTPS Proxy Password (optional, default: empty) - The password to use when connecting to the server using the HTTPS Proxy.
SaaS Management
- Login URL - Needed to fetch SaaS data.
- Redirect URL - The Lucidchart OAuth app URI. The format for this URL is "https://lucid.app/oauth2/clients{CLIENT_ID}/redirect"
- Account ID - Your Lucidchart account ID. This is the number in your admin console URL.
For example, if your URL is "https://admin.lucid.app/teams/123456789#/", then enter 123456789 in the Account name field. - Username and Password - The username and the password of an Axonius user account.
- 2FA Secret - If the user created to collect SaaS Management data accesses Lucidchart through an SSO solution that requires 2-factor authentication, you will need to generate a secret key in that solution and paste it here. See Set Up Google Authenticator in for the Okta adapter, for an example.
To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.
APIs
Axonius uses the Lucid API Version 1.
Required Ports
Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:
80
443
The user you create must have Developer privileges.
Generating a Client ID, Client Secret, and Redirect URL
The Lucidchart adapter uses Oauth2 verification, which requires a Client ID and Client Secret.
- Login as an Account Admin user to your Lucid admin console.
- Ensure that the account has Developer Tools Enabled.
- From the left navigation menu, go to App Integration > General > Custom OAuth app.
- Under the Create Custom OAuth 2.0 Client section, provide a name for your app and click on Create OAuth 2.0 Client.
A new app is added. - Grant the View users on your account permission for the app.
- Open the new app and click the OAuth 2.0 tab.
- Copy the generated Client ID and Client Secret. Paste them in their corresponding parameters in Axonius.
- (For accounts with the SaaS Management module) paste the following URL in the Redirect URL parameter (make sure to add your Client ID into the URL):
https://lucid.app/oauth2/clients{CLIENT_ID}/redirect
Getting the Access Code
This process creates an Account Token. For more information, see Access Token Types.
- Navigate to: https://lucid.app/oauth2/authorizeAccount?client_id={CLIENT_ID}&redirect_uri=https://lucid.app/oauth2/clients/{CLIENT_ID}/redirect&scope=account.user:readonly+offline_access
- Click Grant Access.
You will be redirected to lucid.app/oauth2/clients/{CLIENT_ID}/redirect. - Underneath the Verification code, click Copy to Clipboard.
- In Axonius paste the verification code in the One Time OAuth Access Code field.
To Access SaaS Data
Create a New User Account
- Login as an admin user to your Lucid admin console.
- From the left navigation menu, go to Users.
- Click Add Users > Add a single user.
- Provide an email address you can access.
- Edit the users' roles and set it as Team Admin Privileges, Developer Privileges, and Billing Admin Privileges.
- You will receive an activation mail. Open the mail and use it to set the password.
- Copy the generated Username and Password.
- Paste the copied values into their parameters in Axonius.
Version Matrix
This adapter was only tested with the versions marked as supported, but may work with other versions. Contact Axonius Support if you have a version that is not listed, which is not functioning as expected.
Version | Supported | Notes |
---|---|---|
API v1 | Yes |
Supported From Version
Supported from Axonius version 5.0