Metadata-Version: 2.1
Name: cyral
Version: 2.4.0
Summary: The Cyral CLI tool
License: MIT
Author: Deepak Gupta
Author-email: deepak@cyral.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: awscli (>=1.25,<2.0)
Requires-Dist: click (>=8.1,<9.0)
Requires-Dist: columnar (>=1.4,<2.0)
Requires-Dist: oauthlib (>=3.2,<4.0)
Requires-Dist: requests (>=2.31,<3.0)
Description-Content-Type: text/markdown

# The Cyral CLI Tool

Use this tool to obtain credentials for accessing a data repo via the Cyral sidecar.

**Note 1** This tool does not work with Cyral versions before 3.0. If you are using an
older version of Cyral, please use the [gimme-db-token](https://pypi.org/project/cyral-gimme-db-token/)
tool instead.

**Note 2** Use version 1.x of this tool for Cyral version 3.X and version 2.x for Cyral version 4.X and greater.

---

## Usage
```
cyral [OPTIONS] COMMAND [ARGS]...
```

  The Cyral CLI

### Options
|Name|Description|
|---|---|
|`--cp-address TEXT`|Cyral Control Plane Address|
|`--idp TEXT`|Identity Provider to use to authenticate to Cyral|
|`--local-port INTEGER`|Local port number for receiving OAuth2 redirects  [default: 8005]|
|`--stored-creds / --no-stored-creds`|Use and/or store refresh token in ~/.cyral  [default: stored-creds]|
|`--offline-access / --no-offline-access`|Obtain a (long lived) offline refresh token  [default: no-offline-access]|
|`--realm TEXT`|Authentication realm (usually not needed)  [default: default]|
|`--version`|Show the version and exit.|
|`--help`|Show this message and exit.|

### Commands
|Name|Description|
|---|---|
|`access`|Access a data repo.|
|`help`|Prints detailed usage information including commands,...|
|`sidecar`|Sidecar related commands|

## Usage
```
cyral help [OPTIONS]
```

  Prints detailed usage information including commands, subcommands, and
  options.

### Options
|Name|Description|
|---|---|
|`-f, --output-format [plain \| md]`|Output format  [default: plain]|
|`--help`|Show this message and exit.|

## Usage
```
cyral access [OPTIONS] COMMAND [ARGS]...
```

  Access a data repo.

### Options
|Name|Description|
|---|---|
|`--help`|Show this message and exit.|

### Commands
|Name|Description|
|---|---|
|`pg`|Configure access to postgres databases via Cyral in .pgpass file.|
|`repo`|Obtain information to access a data repo|
|`s3`|Configure AWS profile for accessing S3 via Cyral sidecar.|
|`token`|Obtain access token for accessing a data repo.|

## Usage
```
cyral access token [OPTIONS]
```

  Obtain access token for accessing a data repo.

### Options
|Name|Description|
|---|---|
|`-h, --help`|Show help message and exit.|

## Usage
```
cyral access repo [OPTIONS]
```

  Obtain information to access a data repo

### Options
|Name|Description|
|---|---|
|`-n, --name TEXT`|Repo name in Cyral (substring match)|
|`--tag TEXT`|Repo tag (substring match)|
|`-t, --type [auroramysql \| aurorapostgres \| denodo \| dremio \| galera \| mariadb \| mongodb \| mysql \| oracle \| postgresql \| redshift \| s3 \| sqlserver]`|Repo type|
|`--repos-per-page INTEGER`|Number of repos shown per page  [default: 10]|
|`-f, --output-format [plain \| json]`|Output format  [default: plain]|
|`-h, --help`|Show help message and exit.|

## Usage
```
cyral access s3 [OPTIONS]
```

  Configure AWS profile for accessing S3 via Cyral sidecar.

### Options
|Name|Description|
|---|---|
|`--aws-profile TEXT`|Name of the AWS profile to configure  [default: cyral]|
|`--autoconfigure / --no-autoconfigure`|Autoconfigure (without confirmation) S3 proxy settings  [default: no-autoconfigure]|
|`--account-name TEXT`|Preferred account name to use for accessing the s3 repo|
|`--silent / --no-silent`|Do not print confirmation messages  [default: no-silent]|
|`-h, --help`|Show help message and exit.|

## Usage
```
cyral access pg [OPTIONS]
```

  Configure access to postgres databases via Cyral in .pgpass file.

### Options
|Name|Description|
|---|---|
|`--silent / --no-silent`|Do not print confirmation messages  [default: no-silent]|
|`-h, --help`|Show help message and exit.|

## Usage
```
cyral sidecar [OPTIONS] COMMAND [ARGS]...
```

  Sidecar related commands

### Options
|Name|Description|
|---|---|
|`--id TEXT`|the id of the sidecar|
|`--name TEXT`|the name of the sidecar|
|`--help`|Show this message and exit.|

### Commands
|Name|Description|
|---|---|
|`get`|Get information about sidecars in the control plane.|
|`set`|Set different sidecar options.|

## Usage
```
cyral sidecar get [OPTIONS]
```

  Get information about sidecars in the control plane.

### Options
|Name|Description|
|---|---|
|`--output-format [yaml \| json \| table]`|output format  [default: table]|
|`-h, --help`|Show help message and exit.|

## Usage
```
cyral sidecar set [OPTIONS] COMMAND [ARGS]...
```

  Set different sidecar options.

### Options
|Name|Description|
|---|---|
|`--help`|Show this message and exit.|

### Commands
|Name|Description|
|---|---|
|`log-level`|Set the log level for a sidecar service.|

## Usage
```
cyral sidecar set log-level [OPTIONS]
```

  Set the log level for a sidecar service. The argument can be of the form
  <level> (log level applicable to all services) or <service>:<level> (log
  level for a specific service). <level> can be one of fatal, error, warn,
  info, debug, or trace. The list of services may vary depending on the
  sidecar version and configuration. This option can be specified multiple
  times, the last log level specified for a service is the one that is set.

  ### Examples

  #### set the level for all services

  `cyral sidecar set log-level --level debug`

  #### set the level for a single service

  `cyral sidecar set log-level --level dispatcher:warn`

  #### set the level for multiple services

  `cyral sidecar set log-level --level dispatcher:warn --level pg-wire:debug`

### Options
|Name|Description|
|---|---|
|`--level TEXT`|requested log level|
|`-h, --help`|Show help message and exit.|


---
# Release Notes

## 2.4.0
* (Enhancement) Add `help` command for comprehensive command help.
* (Bug Fix) Disable option validity checking when `--help` is specified.
## 2.3.0
* (Enhancement) Allow users to choose account name for S3 access.
## 2.2.4
* (Chore) Update dependency versions.
## 2.2.3
* (Enhancement) Support new certificate download endpoint on Cyral Control Plane.
## 2.2.2
* (Bug Fix) Support `aws s3api` command.
## 2.2.1
* (Bug Fix) Make changes compatible with Python version 3.9.
## 2.2.0
* (Enhancement) Add `sidecar` command.
## 2.1.1
* (Enhancement) Add `--realm` option to support some older control planes.
## 2.0.1
* (Bug Fix) Choose non-proxy mode port for S3 repo.
## 2.0.0
* (Enhancement) Add support for Cyral Control Plane v4.x.
---

