Connect Cisco Meraki
There is no key to create or type here: Cisco Meraki connects through OAuth 2.0 authorization. You are sent to Meraki, you authorize Alerion, then you return to Alerion. Alerion reads your Meraki organizations, networks and devices read-only.
Prerequisites
- An administrator account of the Meraki organization to connect. The official page does not state the exact role needed to authorize an integration; it does say that only an organization administrator can remove it from the dashboard.
- Meraki's documentation states OAuth is currently supported only in the
meraki.comcluster. If your organization is hosted elsewhere, connecting may not be possible; the page does not detail this case. - An Alerion plan that includes the connector (Business or above).
Authorize Alerion step by step
- In Alerion, open Settings → Connectors and click Connect on the Cisco Meraki card. Alerion first shows what it will read.
- You are redirected to Meraki's authorization page (
as.meraki.com). Authorize the request; the official page does not describe the consent screen itself, so review the requested permissions before approving. - Meraki sends you back to Alerion with an authorization code (valid 10 minutes per the official page). Alerion exchanges it for an access token (valid 60 minutes, refreshed automatically): there is nothing for you to copy.
- If your Alerion space has several Meraki organizations, choose the one to connect.
Permissions requested (all read)
Read the list of your organizations, networks and devices (names, models, serial numbers, firmware); online/offline state and topology; licence status and expiry; high availability and Internet link state of MX firewalls; MS switches and MR access points (model, name, firmware, state). Alerion reads no cameras, sensors or endpoints, and writes nothing.
Value of each Alerion form field
There is no form: the only input is the authorization at Meraki.
Verification
Back in Alerion, the Meraki card shows "connected" and the connection page shows the date of the last synchronisation.
Removing access
On the Meraki side (organization administrators only): Organization → Integrations, tab My integrations, open the integration and click Remove at the top right. The refresh token is revoked; the access token may keep working for up to 10 minutes. In Alerion you can also disconnect the connector from the connection page.
Common errors
- Authorization declined or abandoned: click Connect again.
- Expired link: the authorization code is only valid for 10 minutes, start again.
- Organization already connected to another Alerion space: Alerion refuses to link the same organization twice; disconnect it from the other space first.
Sources
- Cisco Meraki, "OAuth overview" (authorization flow, lifetimes, revocation): https://developer.cisco.com/meraki/api-v1/oauth-overview/
- Cisco Meraki, "Authorization" (app-scoped OAuth access and API keys): https://developer.cisco.com/meraki/api-v1/authorization/