example7-getOrgPIIKeys-email.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""MerakiPII Sample Script.

Copyright (c) 2019 Cisco and/or its affiliates.

This software is licensed to you under the terms of the Cisco Sample
Code License, Version 1.1 (the "License"). You may obtain a copy of the
License at

               https://developer.cisco.com/docs/licenses

All use of the material herein must be in accordance with the terms of
the License. All rights not expressly granted by the License are
reserved. Unless required by applicable law or agreed to separately in
writing, software distributed under the License is distributed on an "AS
IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
or implied.

"""

__author__ = "Zach Brewer"
__email__ = "zbrewer@cisco.com"
__version__ = "0.1.0"
__copyright__ = "Copyright (c) 2019 Cisco and/or its affiliates."
__license__ = "Cisco Sample Code License, Version 1.1"

# simple example script that uses MerakiPII.PIICalls module to get all required to access PII for a given identifier_value
# data from this API call/example can be used to make PII delete or restrict processing requests (these start with example19)
# Make sure to check the API Documentation - some attributes are for Systems Manager (SM) Orgs/Networks only

# API Documentation for this call:  
# https://dashboard.meraki.com/api_docs#list-the-keys-required-to-access-personally-identifiable-information-pii-for-a-given-identifier_value

# If you don't have a test environment, you can use DevNet Meraki Cloud Sandbox with a free account:
# https://devnetsandbox.cisco.com/RM/Diagram/Index/a9487767-deef-4855-b3e3-880e7f39eadc?diagramType=Topology

# see getOrgPIIKeys function in PIICalls module for details and arguments

# see the 1st example (example1-getOrgPIIRequests.py) for various ways to assign values for API calls
# for this file and other examples, we are using config.ini file for values

# next line imports PIICalls.py from the MerakiPII directory
from MerakiPII import PIICalls
import configparser
import json

# load config.ini and assign config variables from appropriate section to variables
config = configparser.ConfigParser()
config.read('config.ini')
apikey = config['DEFAULT-KEYS-EMAIL']['API_KEY']
orgid = config['DEFAULT-KEYS-EMAIL']['ORG_ID']
identifier_value = config['DEFAULT-KEYS-EMAIL']['IDENTIFIER_VALUE']
identifier_type = config['DEFAULT-KEYS-EMAIL']['IDENTIFIER_TYPE']

print('\nAssociated PII Keys from this call can be used in PII delete or restrict processing requests.'
        '\n'
        'See "example19-SubmitNewOrgDelRequest-MAC" and above for PII delete or restrict processing requests.'
        '\n\n'
        'Making PII Key API call for identifier_value type ' + '"' + identifier_type + '"' + ' with the value of '+ '"' + identifier_value + '"' + ':'
        '\n...'
        )

MyOrgPIIKeys = PIICalls.getOrgPIIKeys(apikey, orgid, identifier_type, identifier_value)
print(json.dumps(MyOrgPIIKeys, indent=4, sort_keys=False))