---
title: Managing the allow list
description: To manage operations for OAuth2 Tokens, cookies, IP addresses, API keys, and usernames on an allow list:
component: pingintelligence
version: 5.2
page_id: pingintelligence:pingintelligence_reference_guide:pingintelligence_managing_allow_list
canonical_url: https://docs.pingidentity.com/pingintelligence/5.2/pingintelligence_reference_guide/pingintelligence_managing_allow_list.html
revdate: April 3, 2024
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
  example-4: Example:
  example-5: Example:
  example-6: Example:
  example-7: Example:
  example-8: Example:
---

# Managing the allow list

## About this task

To manage operations for OAuth2 Tokens, cookies, IP addresses, API keys, and usernames on an allow list:

## Steps

* To add an IP address to an allow list, run the `add_whitelist` command with the `ip` option.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin add_whitelist ip 10.10.10.10
  ip 10.10.10.10 added to whitelist
  ```

* Add a cookie to an allow list, run the `add_whitelist` command with the `cookie` option.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin add_whitelist cookie JSESSIONID cookie_1.4
  cookie JSESSIONID cookie_1.4 added to whitelist
  ```

* To add a token to an allow list, run the `add_whitelist` with the `token` option.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin add_whitelist token token1.4
  token token1.4 added to whitelist
  ```

* To add an API key to an allow list, run the `add_whitelist` command with the `api_key` option.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin add_whitelist api_key X-API-KEY key_1.4
  api_key X-API-KEY key_1.4 added to whitelist
  ```

* To add a username to an allow list, run the `add_whitelist` command with the `username` option.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin add_whitelist username abc@example.com
  username abc@example.com added to whitelist
  ```

* To view an allow list, run the `view_whitelist` command.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin view_whitelist
  Whitelist
  1) type : ip, value : 1.1.1.1
  2) type : cookie, name : JSESSIONID, value : cookie_1.1
  3) type : token, value : token1.3
  4) type : api_key, name : X-API-KEY, value : key_1.4
  5) type : username, value : abc@example.com
  ```

* To delete an entry from an allow list, run the `delete_whitelist` command.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin delete_whitelist ip 4.4.4.4
  ip 4.4.4.4 deleted from whitelist

  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin delete_whitelist cookie JSESSIONID cookie_1.1
  cookie JSESSIONID cookie_1.1 deleted from whitelist

  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin delete_whitelist token token1.1
  token token1.1 deleted from whitelist

  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin delete_whitelist api_key X-API-KEY key_1.4
  api_key X-API-KEY key_1.4 deleted from whitelist

  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin delete_whitelist username abc@example.com
  ```

* To clear the allow list, run the `clear_whitelist` command.

  ### Example:

  ```
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin clear_whitelist
  This will delete all whitelist Attacks, Are you sure (y/n) : y
  Whitelist cleared
  /opt/pingidentity/ase/bin/cli.sh -u admin -p admin clear_whitelist
  This will delete all whitelist Attacks, Are you sure (y/n) : n
  Action canceled
  ```