https://github.com/akamai/cli-eaa
CLI for Enterprise Application Access (EAA)
https://github.com/akamai/cli-eaa
akamai akamai-cli cli-eaa enterprise-cli logs siem
Last synced: 6 months ago
JSON representation
CLI for Enterprise Application Access (EAA)
- Host: GitHub
- URL: https://github.com/akamai/cli-eaa
- Owner: akamai
- License: apache-2.0
- Created: 2019-12-23T19:18:11.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-19T22:22:01.000Z (10 months ago)
- Last Synced: 2024-08-20T02:36:40.777Z (10 months ago)
- Topics: akamai, akamai-cli, cli-eaa, enterprise-cli, logs, siem
- Language: Python
- Homepage: https://www.akamai.com/us/en/products/security/enterprise-application-access.jsp
- Size: 563 KB
- Stars: 23
- Watchers: 15
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Akamai CLI: Enterprise Application Access
## Table of contents
- [Screenshot](#screenshot)
- [Introduction](#introduction)
- [Key features](#key-features)
- [Installation / upgrade](#installation--upgrade)
- [Examples](#examples)
- [EAA Event Logs](#eaa-event-logs)
- [Applications](#applications)
- [Directory operations](#directory-operations)
- [Connectors](#connectors)
- [Certificate management](#certificate-management)
- [Device Posture Inventory](#device-posture-inventory)
- [Known Limitations](#known-limitations)
- [Troubleshooting and Support](#troubleshooting-and-support)
- [Self-troubleshooting](#self-troubleshooting)
- [Support](#support)
## Screenshot
## Introduction
[Enterprise Application Access (EAA)](https://www.akamai.com/us/en/products/security/enterprise-application-access.jsp) comes with a full suite of APIs.
To interact with the service, you can:
- write your own scripts
- use [Postman](https://developer.akamai.com/authenticate-with-postman)
- use [Terraform EAA](https://github.com/akamai/terraform-eaa)
- ... or use [Akamai CLI](https://developer.akamai.com/cli) to run common operations directly from the command line, no coding required.
This can be helpful if you plan to consume EAA logs into your favorite SIEM or automate your workflow with Bash, Powershell, a deployment solution like Ansible, or a CI/CD pipeline.
## Key features
- Event logs
- View access logs (identification, application activity)
- View admin logs (admin portal access, config change, deployment, deletion)
- Send the logs to a file
- Blocking mode (similar to `tail -f`) Alternatively, you can specify a date range with `--start` and `--end`
- Application
- Save, restore/update, deploy
- Batch operation
- Attach/detach connectors
- Directory
- Create groups and group overlays
- Synchronize with your LDAP or Active Directory
- Identity Providers (IdP)
- List configured IdPs and their status
- Certificate management
- List configured certificates
- Rotate certificate with optional deployment of dependent applications and IdP
- Connectors
- List all connectors including the reachability status and health
- Show all applications used by a connector and a breakdown of active connection
- Swap a connector (for applications only)
## Installation / upgrade
See [install.md](docs/install.md)
## Examples
### EAA Event Logs
See [`akamai eaa log` documentation page](docs/commands/akamai-eaa-log.md)
### Applications
See [`akamai eaa app` documentation page](docs/commands/akamai-eaa-app.md).
### Directory operations
See [`akamai eaa log` documentation page](docs/commands/akamai-eaa-dir.md)
### Connectors
See [`akamai eaa connector` documentation page](docs/commands/akamai-eaa-connector.md).
### Certificate management
See [`akamai eaa certificate` documentation page](docs/commands/akamai-eaa-certificate.md).
### Device Posture Inventory
See [`akamai eaa dp` documentation page](docs/commands/akamai-eaa-dp.md).
## Known Limitations
While updating an application from a JSON, only a subset of the data will be updated in the back-end, not the entire application configuration.
## Troubleshooting and Support
### Self-troubleshooting
If the command is not working properly, you can increase the level of verbosity using:
- `-v` or `--verbose` to trace the main steps
- `-d` or `--debug` to get full visibility, include API HTTP headers
The messages are printed on _stderr_ so you can safely redirect stdout to a file or use the `--output` option.
### Support
`cli-eaa` is provided as-is and it is not supported by Akamai Support.
To report any issue, feature request or bug, please open a new issue into the [GitHub Issues page](https://github.com/akamai/cli-eaa/issues)
We strongly encourage developers to create a pull request for any issues.