Konektor Cisco Meraki

Tento konektor importuje hostitele z Cisco Meraki do Alvao jako objekty a při každé detekci události v Meraki vytvoří související požadavek v Alvao.

Konektor periodicky (každou hodinu) čte informace v Meraki a aktualizuje odpovídající objekty reprezentující zařízení v Alvau.

Při prvním spuštění importu jsou objekty Alvao spárovány se zařízeními Meraki podle vlastnosti objektu Sériové číslo BIOSu nebo MAC adresa.

Pokud pro danou MAC adresu nebo sériové číslo není nalezen žádný objekt Alvao, je vytvořen nový objekt Alvao ve složce Importované objekty ve stromu objektů. Alvao automaticky zvolí nejvhodnější typ objektu pro nový objekt. Pravidelně kontrolujte obsah složky. V případě potřeby změňte typ nově vytvořených objektů a přesuňte objekty na vhodná místa ve stromu objektů.

Pro všechny objekty spárované se zařízením v Meraki nastavuje konektor objektovou vlastnost ID zařízení Cisco Meraki.

Vlastnost Poslední přihlášení Cisco Meraki udává přesné datum a čas, kdy bylo zařízení naposledy online.

Konektor může aktualizovat následující vlastnosti objektu:

• Hostname
• Operační systém
• Model
• Sériové číslo
• MAC adresy
• Výrobce
• ID zařízení Cisco Meraki
• Poslední přihlášení Cisco Meraki

Vlastnosti jsou automaticky přidány k uvedeným typům objektu při prvotním spuštění konektoru. Pokud plánujete použít nějaké jiné typy objektů s tímto konektorem, přidejte k nim tyto vlastnosti ručně.

Požadavky

• ALVAO Asset Management nebo ALVAO Service Desk a modul ALVAO Monitoring Connectors
• Cisco Meraki

Import majetku z Cisco Meraki do Alvao

Pro použití této funkce potřebujete ALVAO Asset Management Monitoring Connector.

Získání tokenu Cisco Meraki

1. V přehledu Cisco Meraki klikněte na nabídku Organization a přejděte na stránku API & Webhooksy.
2. Přejděte na záložku API keys and access.
3. Klikněte na Generate API Key a zkopírujte klíč do schránky.

Nastavení systému Alvao

1. Přejděte do Správa – Aplikace a vyberte aplikaci Konektor Cisco Meraki.

   Manuální stažení: CiscoMerakiConnector.xml

2. Nakonfigurujte následující nastavení aplikace:

   • CiscoMeraki.Token – zadejte vytvořený token z předchozích kroků.

3. Aplikaci aktivujte pomocí příkazu Povolit.

4. Během hodiny budou v složce Importované objekty na stránce Objekty vytvořeny nové objekty reprezentující hosty Meraki.

Nastavení systému Alvao

1. Přejděte do Správa – Nastavení – Pokročilé nastavení a vytvořte Nové nastavení – vyberte název CiscoMeraki.WebhookSharedSecret a jako hodnotu zadejte Sdílený tajný klíč z webhooku.

2. Vytvořte novou Službu pro vytváření požadavků (vyplňte pole Název a Popis).

3. Vytvořte aplikační účet, nastavte jeho heslo a předejte mu role hlavní řešitel a žadatel u dříve vytvořené služby a oprávnění ke čtení objektů v Asset Management.

Nastavení Cisco Meraki

1. V přehledu Cisco Meraki klikněte na nabídku Organization a přejděte na stránku API & Webhooks.
2. Přejděte na záložku Webhooks a v ní na záložku Templates.
3. Klikněte na Create template a vyplňte formulář takto:

   • Template name - Alvao

   • Liquid body:

     {
     "version": "0.1",
     "sharedSecret": "{{sharedSecret}}",
     "sentAt": "{{sentAt}}",
     "organizationId": "{{organizationId}}",
     "organizationName": "{{organizationName}}",
     "organizationUrl": "{{organizationUrl}}",
     "networkId": "{{networkId}}",
     "networkName": "{{networkName}}",
     "networkUrl": "{{networkUrl}}",
     "networkTags": {{ networkTags | jsonify }},
     "deviceSerial": "{{deviceSerial}}",
     "deviceMac": "{{deviceMac}}",
     "deviceName": "{{deviceName}}",
     "deviceUrl": "{{deviceUrl}}",
     "deviceTags": {{ deviceTags | jsonify }},
     "deviceModel": "{{deviceModel}}",
     "alertId": "{{alertId}}",
     "alertType": "{{alertType}}",
     "alertTypeId": "{{alertTypeId}}",
     "alertLevel": "{{alertLevel}}",
     "occurredAt": "{{occurredAt}}",
     "alertData": {{ alertData | jsonify }},
     "alvaoServiceId": 123,
     "alvaoRequesterId": 123
     }

     • alvaoServiceId = ID služby Alvao, kde bude vytvořen požadavek. Najdete jej v URL na stránce Správa - Service Desk - Služby - stránka služby konkrétní služby.
     • alvaoRequesterId = ID žadatele požadavku. Najdete jej v URL na stránce Správa - Uživatelé – stránka konkrétního uživatele.

   • Klikněte na Uložit.

   • Na záložce Webhooks přejděte na záložku Recievers.

   • Klikněte na Add receiver a vyplňte takto:

     • Name - například Vytvořit požadavek v Alvao
     • URL - zadejte URL Alvao REST API, následované cestou /connectors/CiscoMerakiCallback, např.: https://contoso.onalvao.com/AlvaoRestApi/connectors/CiscoMerakiCallback.
     • Shared secret* - vytvořte tajný kód
     • Payload template - Alvao

   • Klikněte na Uložit.

   • Nastavte vytvořený webhook jako příjemce požadovaných upozornění.