Configuring the personally identifiable information marker

You can configure the personally identifiable information (PII) marker which is used to mark assets that contain sensitive data.

Before you begin

Required role: To configure the PII marker, you must have the Suite Administrator role.

About this task

The personally identifiable information (PII) marker is a text value that is used to mark the assets that contain sensitive data. Such data can be used to identify a particular person. PII assets are marked with the letter P in the relationship graph. The assets are marked as PII when a label that contains the marker in its description is applied to these assets. For example, when the value of the marker is PII, you have a label called Home address, and this label contains the description Specifies home address of customers. Contains PII., then all assets to which this label is applied are marked with the P letter in the relationship graph.

The default value of the marker is PII. To change it, complete the following steps.

Note: PII marker can contain only one value. This value is case-sensitive.

Procedure

Generate the access token by running the following command. Replace enterprise_search_host, username, and password with your values.

curl -ik -X POST https://enterprise_search_host/ibm/iis/api/auth_token/v1/tokens -d '{"username":"username","password":"password"}'

The example output of this command has the following form:

$ curl -ik -X POST https://enterprisesearchhostname.com/ibm/iis/api/auth_token/v1/tokens -d '{"username":"isadmin","password":"passw0rd"}'
HTTP/1.1 200 OK
Server: nginx/1.10.3 (Ubuntu)
Date: Thu, 07 Dec 2017 13:58:34 GMT
Content-Type: application/json
Content-Length: 1356
Connection: keep-alive
X-Powered-By: Servlet/3.1
Content-Language: en-US
Set-Cookie: JSESSIONID=0000hrVdvUPLiRDOK7HBWON4SQD:a907f749-957d-4874-8f1e-6e781c920f07; Path=/; Secure; HttpOnly
Set-Cookie: LtpaToken2=dJmwte5z0PRGM89kRBRbmCYvQ2RuGEZDpjhJ4w5E4tPlTkDzHgWs143mHhYhyNWgBvPM1xL8BpTzloKJbrCrHrNxmzBUI4PTvaff2/NEtap0vZSsxQne9DTsh5GK18D82w7kzkWrYVAjJiXTzEPVW8asz3TgAPlK7oV1rxukhBItNnfbRAl7pslwqtQCfxNUqvpCwl40Zg/oW4kaWpVtJtOo7jXCJ/ItK+eopiXCTJsBR2qYtgxM68vzLy+E+L41Oi2akrpkYdWG3ZxMANQx/zgsNTYxA==; Path=/; Secure; HttpOnly
Set-Cookie: X-IBM-IISSessionId={issvr2048:isf}Nt1qmC8pFuyK1KPYtbE3KqBhZGuyikzU0cpXlWGXto4ZaHLeEcNBEpS0zAxy0oC96UDjeyGZnSAST1o7fgtW1hM7iGIBM3beuaNHzofgkAr8GRWCIvxk6aNmO6ElpH48sMizP4DpY8MocpkrFMnrNQNKF87MsbHozrCO3YQ7Ubj78pEeahtpH7aqDAkN1UfL2cJqRfWbSnDU57VTSnSrbVXx-09S5uHbUTVvyCKXnabZKTWx7n-wTFvXMmL8PTcZxAvbAG465tq2hYpVGrcWqx5oZh9GKhjYMFILrrttPkkpsSe_wXcVfXhx8RewnA..; Path=/; Secure; HttpOnly
Expires: Thu, 01 Dec 1994 16:00:00 GMT
Cache-Control: no-cache="set-cookie, set-cookie2"

{
  "access_token": "Y8iBBtLco9QimQSF9cWjE0Ze490BaAFkEIytoDaofR.icfhF8pPwWJ5pQlwb7k2O8QAw2J7Ho3L0vPKFTxvLHVwtjATCIUo7ZoYyNLzRIw5mxxRV49HYi55FXX2gZWn4Z7TTqOaMBcXDwFkNSFo43tZoRStVw65liybwOQLkmQDmGCu00BLXcMSErhQeSHAT0KqNt.bPv7JEeY8vLIEaIn6VVPpSwSsDDPtLDUl08HX37uEjg4I88Dpxw8elR63y37tySc17TQqvNWjXLVaZmtt3F28DEl0yEDnZBWUu8CEKrHFojxCzZEyCGlFHyPp0L.yJzeGP31SXG0UefTQHa28XaAaVDSP40tvyGM2DuysUXuvzRtp.tRV5njpccrhrIrY94G9iPT20JEfrqKPaWj0VGJcRJQ0HnHTDmSQCZA7RyIeeC9UeHjrBkihTGAszai0tKa14751jAW3LYIybJyLMGGiISPllFAsKqBvUMCh3Sn1EsGCMY2AK",
  "token_type": "bearer",
  "expires_in": 3600
}

The token is the value of the access_token parameter.

Get the current value of the PII marker by running the following command. Replace enterprise_search_host with your value, and access_token with the token that you generated in the previous step.

curl -ik https://enterprise_search_host/ibm/iis/api/app_config/v1/global_settings/shop4info.graph.pii_marker -H 'Authorization: Bearer access_token'

The example output of this command has the following form:

$ curl -ik https://enterprisesearchhostname.com/ibm/iis/api/app_config/v1/global_settings/shop4info.graph.pii_marker -H 'Authorization: Bearer Y8iBBtLco9QimQSF9cWjE0Ze490BaAFkEIytoDaofR.icfhF8pPwWJ5pQlwb7k2O8QAw2J7Ho3L0vPKFTxvLHVwtjATCIUo7ZoYyNLzRIw5mxxRV49HYi55FXX2gZWn4Z7TTqOaMBcXDwFkNSFo43tZoRStVw65liybwOQLkmQDmGCu00BLXcMSErhQeSHAT0KqNt.bPv7JEeY8vLIEaIn6VVPpSwSsDDPtLDUl08HX37uEjg4I88Dpxw8elR63y37tySc17TQqvNWjXLVaZmtt3F28DEl0yEDnZBWUu8CEKrHFojxCzZEyCGlFHyPp0L.yJzeGP31SXG0UefTQHa28XaAaVDSP40tvyGM2DuysUXuvzRtp.tRV5njpccrhrIrY94G9iPT20JEfrqKPaWj0VGJcRJQ0HnHTDmSQCZA7RyIeeC9UeHjrBkihTGAszai0tKa14751jAW3LYIybJyLMGGiISPllFAsKqBvUMCh3Sn1EsGCMY2AK'
HTTP/1.1 200 OK
Server: nginx/1.10.3 (Ubuntu)
Date: Thu, 07 Dec 2017 14:00:00 GMT
Content-Type: application/json
Content-Length: 122
Connection: keep-alive
X-Powered-By: Servlet/3.1
Content-Language: en-US

{
  "key": "shop4info.graph.pii_marker",
  "value": "PII",
  "modified": "2017-12-04T08:11:25Z",
  "modifier": "isadmin"
}

The current value is specified in the value parameter.

Set the new value by running the following command. Replace enterprise_search_host with your value, and access_token with the token that you generated in step 1. Specify the new value in the value parameter.

curl -ik https://enterprise_search_host/ibm/iis/api/app_config/v1/global_settings/shop4info.graph.pii_marker -X PUT -d '{"value":"new PII marker value"}' -H 'Content-Type: application/json' -H 'Authorization: Bearer access_token'

The example output of this command has the following form:

$ curl -ik https://enterprisesearchhostname.com/ibm/iis/api/app_config/v1/global_settings/shop4info.graph.pii_marker -X PUT -d '{"value":"sensitive data"}' -H 'Content-Type: application/json' -H 'Authorization: Bearer Y8iBBtLco9QimQSF9cWjE0Ze490BaAFkEIytoDaofR.icfhF8pPwWJ5pQlwb7k2O8QAw2J7Ho3L0vPKFTxvLHVwtjATCIUo7ZoYyNLzRIw5mxxRV49HYi55FXX2gZWn4Z7TTqOaMBcXDwFkNSFo43tZoRStVw65liybwOQLkmQDmGCu00BLXcMSErhQeSHAT0KqNt.bPv7JEeY8vLIEaIn6VVPpSwSsDDPtLDUl08HX37uEjg4I88Dpxw8elR63y37tySc17TQqvNWjXLVaZmtt3F28DEl0yEDnZBWUu8CEKrHFojxCzZEyCGlFHyPp0L.yJzeGP31SXG0UefTQHa28XaAaVDSP40tvyGM2DuysUXuvzRtp.tRV5njpccrhrIrY94G9iPT20JEfrqKPaWj0VGJcRJQ0HnHTDmSQCZA7RyIeeC9UeHjrBkihTGAszai0tKa14751jAW3LYIybJyLMGGiISPllFAsKqBvUMCh3Sn1EsGCMY2AK'
HTTP/1.1 200 OK
Server: nginx/1.10.3 (Ubuntu)
Date: Thu, 07 Dec 2017 14:01:22 GMT
Content-Type: application/json
Content-Length: 122
Connection: keep-alive
X-Powered-By: Servlet/3.1
Content-Language: en-US

{
  "key": "shop4info.graph.pii_marker",
  "value": "sensitive data",
  "modified": "2017-12-07T14:01:22Z",
  "modifier": "isadmin"
}

In this example, the new value is sensitive data.