Admin Guide

Synapse-WiGLE Admin Guide

Configuration

Synapse-WiGLE requires a WiGLE API name and token. For information on how to sign up, please visit the WiGLE API documentation.

Setting API credentials for global use

To set-up global API credentials:

> wigle.config.add default myapiname myapitoken
Synapse-WiGLE config "default" added

Creating a configuration for role-based use

Add an unscoped configuration:

> wigle.config.add myunscoped myapiname myapitoken --scope unscoped
Synapse-WiGLE config "myunscoped" added

Grant another user admin permissions to the new configuration:

> wigle.config.update myunscoped --perm user visi admin
Updated Synapse-WiGLE config "myunscoped"

Grant a role read permissions to the new configuration:

> wigle.config.update myunscoped --perm role ninjas read
Updated Synapse-WiGLE config "myunscoped"

Users may select a configuration other than their default by passing --config <name> to the Synapse-WiGLE commands.

Overriding the proxy configuration

In order to override the default proxy configuration in the Cortex the user must have the power-ups.wigle.admin or storm.lib.inet.http.proxy permission.

When the proxy configuration is set to (false) or a URL the permission will be checked when a configuration is created/updated, and when it is used to make an HTTP request.

Dependencies

Synapse-WiGLE will conflict with the following Power-Ups:

Name   : wigle
Version: any

Permissions

Package (synapse-wigle) defines the following permissions:
power-ups.wigle.user             : Controls user access to Synapse-WiGLE. ( default: false )
power-ups.wigle.admin            : Controls access to Synapse-WiGLE admin options. ( default: false )

You may add rules to users/roles directly from Storm:

> auth.user.addrule visi power-ups.wigle.user
Added rule power-ups.wigle.user to user visi.

or:

> auth.role.addrule ninjas power-ups.wigle.user
Added rule power-ups.wigle.user to role ninjas.

Exported APIs

Synapse-WiGLE does not currently export any APIs.

Workflows

Synapse-WiGLE provides the following workflows in Optic:

Title: Configuration

The Configuration workflow may be used to manage Synapse-WiGLE configurations from Optic.

Node Actions

Synapse-WiGLE provides the following node actions in Optic:

Name : network.search
Desc : Search for wifi networks.
Forms: geo:place, inet:wifi:ap

Name : network.detail
Desc : Get details for a single wifi network.
Forms: inet:wifi:ap, inet:mac