Revision as of 18:11, May 15, 2018 by Xavier (talk | contribs) (Update with the copy of version: 8.5.xDraft)
Jump to: navigation, search

Web Services & Applications Support for GDPR

Warning
Disclaimer: The information contained here is not considered final. This document will be updated with additional technical information.

This page describes product-specific aspects of Web Services & Applications support for the European Union's General Data Protection Regulation (GDPR) in premise deployments. For general information about Genesys support for GDPR compliance, see General Data Protection Regulation.

Warning
Disclaimer: The information contained here is not considered final. This document will be updated with additional technical information.


Deleting PII

The gdpr_forget_me.py script provides an option to delete personal data from the Personal Favorites where the agent fills the information about the user.

The script can be run with the following parameters:

gdpr_forget_me.py [-h] [--gws GWS] --cass_keyspace CASS_KEYSPACE --cass_hostname CASS_HOSTNAME --cass_port CASS_PORT --search SEARCH [--group_name GROUP_NAME] [--cleanup CLEANUP] [--gws_username GWS_USERNAME] [--gws_user_password GWS_USER_PASSWORD] [--gws_additional_headers GWS_ADDITIONAL_HEADERS]

Prerequisites

The following software packages are required to run this script:

  • Python 2.7
  • PyCassa 1.9.1
  • Requests 2.18.4

Parameters

Parameter Name Mandatory Description
--cass_keyspace CASS_KEYSPACE Yes The Cassandra keyspace name.
--cass_hostname CASS_HOSTNAME Yes The Cassandra host name.
--cass_port CASS_PORT Yes The Cassandra thrift port.
--search SEARCH Yes The text (email or phone number) to be searched for.
-h, --help No Show this help message.
--group_name GROUP_NAME No The user group name.For example, interaction-workspace-personal-favorites.
--cleanup CLEANUP No When set to true, the script will send a request to GWS to delete the settings that match. The default value is false.
--gws_username GWS_USERNAME No The GWS user name with admin privileges. This user is used to delete matching data via GWS API.
--gws_user_password GWS_USER_PASSWORD No The password of the GWS user specified in gws_username.
--gws_additional_headers GWS_ADDITIONAL_HEADERS No The additional headers that will be added to the GWS request. CSRF headers must be added here. Headers are presented as JSON. For example, {"header_name": "header_value"}.

Example

The script will search personal data for deleting by email agent1@pizza.com in all settings groups, but will not delete, because --cleanup argument isn't specified.

  • python gdpr_forget_me.py --cass_keyspace sipfs --cass_hostname localhost --cass_port 9160 --search agent1@pizza.com

The script will search email agent1@pizza.com in all settings groups and delete via GWS API.

  • python gdpr_forget_me.py --cass_keyspace sipfs --cass_hostname localhost --cass_port 9160 --search agent1@pizza.com --gws http://127.0.0.1:8090 --gws_username admin@pizza.com --gws_user_password password --cleanup true

The script will search email agent1@pizza.com in all settings groups and delete via GWS API. The password of gws_username will be encrypted.

  • python gdpr_forget_me.py --cass_keyspace sipfs --cass_hostname localhost --cass_port 9160 --search agent1@pizza.com --gws http://127.0.0.1:8090 --cleanup true

The script will search agent1@pizza.com in settings group with name 'interaction-workspace-personal-favorites' and delete via GWS API. 2 additional headers will be added to requests (X-CSRF-HEADER with value X-CSRF-TOKEN and X-CSRF-TOKEN with value 1434429f-81a8-459a-9d6d-792d17644471).

  • python gdpr_forget_me.py --cass_keyspace sipfs --cass_hostname localhost --cass_port 9160 --search agent1@pizza.com --gws https://gws-api-host:8099 --gws_username admin@pizza.com --gws_user_password password --cleanup true --group_name interaction-workspace-personal-favorites --gws_additional_headers "{\"X-CSRF-HEADER\": \"X-CSRF-TOKEN\", \"X-CSRF-TOKEN\": \"1434429f-81a8-459a-9d6d-792d17644471\"}"
Comments or questions about this documentation? Contact us for support!