Conjur
NOTE: This is work-in-progress, for a future (as yet unreleased) version of Conjur. It will not work with Conjur 4.
Command-line interface to Conjur 5.
A complete reference guide is available at developer.conjur.net.
Quick start
$ docker run -it -v $PWD:/work conjurinc/cli5
root@2b5f618dfdcb:/# conjur -v
conjur version 6.0.0.pre.beta.2
Docker images
Images for development/experimental use are automatically built on docker hub. These are based off Dockerfile.standalone and can be rebuilt with:
docker build . -f Dockerfile.standalone -t conjurinc/cli5
Note these images are not subject to any QA at the moment and so should never be used in production, especially without specific image id pin.
Development
Create a sandbox environment in Docker using the ./dev
folder:
$ cd dev
dev $ ./start.sh
This will drop you into a bash shell in a container called cli
. The sandbox also includes a Postgres container and Conjur server container. The environment is already setup to connect the CLI to the server:
- CONJUR_APPLIANCE_URL
http://conjur
- CONJUR_ACCOUNT
cucumber
You can obtain the API key for the role cucumber:user:admin
from the Docker logs of the Conjur container. Use it to login:
root@2b5f618dfdcb:/# conjur authn login admin
Please enter admin's password (it will not be echoed):
Logged in
At this point, you can use any CLI command you like.
Running Cucumber
To install dev packages, run bundle
from within the container:
root@2b5f618dfdcb:/# cd /usr/src/cli-ruby/
root@2b5f618dfdcb:/usr/src/cli-ruby# bundle
Then you can run the cucumber tests:
root@2b5f618dfdcb:/usr/src/cli-ruby# cucumber
...
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
License
Copyright 2016-2017 CyberArk
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.