Skip to content

Latest commit

 

History

History
115 lines (87 loc) · 3.81 KB

chef-infra-bootstrap-only-key.md

File metadata and controls

115 lines (87 loc) · 3.81 KB

HowTo - Creating a Bootstrap-only Key for Chef Infra Server

In some cases, it is helpful for an organization to want to create keys which can be used to bootstrap new clients to a Chef Infra Server without additional or undesired access levels.

This is intended for reference only and should be validated and tested within a safe development environment.

Before You Start

Assumptions

  • Chef Workstation installed with Administrative access to the organization which will have the new bootstrap-only client created.
  • See https://docs.chef.io/server_orgs/ for details on permissions for objects with Chef Infra Server.

Tested Versions

  • Chef Workstation | 21.8.555
  • Chef Infra Server | 14.8.7

Create a group with specific permissions

  1. Create a new group which will have bootstrap-only permissions that we will adjust assignments for. In this example, this group will be called bootstrap

    knife group create bootstrap

  2. Apply explicit permissions to the bootstrap group to allow it to create new clients and nodes but not update anything which already exists. Below are examples which could be used for minimal access.

    knife acl add group bootstrap containers clients create,read
knife acl add group bootstrap containers nodes create

  3. Create a new client, this is what will be used to authenticate similar to a validator client. Save the key for the client once it gets created.

    knife client create bootstrapclient
    {
"name": "bootstrapclient",
"validator": false,
"admin": false,
"chef_type": "client",
"create_key": true
}

  4. Add the new bootstrapclient user to the bootstrap group and remove it from the clients group

    knife group add client bootstrapclient bootstrap
knife group remove client bootstrapclient clients

Validation

Test it out! In this example, the created client key was saved as bstrap.pem locally and it was verified that it cannot read data which has not been explicitly granted.

  • Try creating a new client & node and listing the existing clients, these access levels should be working correctly:

    $ knife client create testing -u bootstrapclient --key bstrap.pem -d
Created client[testing]
-----BEGIN RSA PRIVATE KEY-----
MIIEowIBAAKCAQEAqsrVkkmJgd3ig5DSZb7JoFntNMJRPy3fXS7zdRImoVwPgTjR
... truncated ...
neQErkFabUrj0aUPgN6/CoNb/ZnIChK2qDUWa8lpya67Oqt07NcB
-----END RSA PRIVATE KEY-----

    $ knife node create testing -u bootstrapclient --key bstrap.pem -d
Created node[testing]

    $ knife client list  -u bootstrapclient --key bstrap.pem
bootstrap
bootstrap-client
bootstrapclient
client01
client02
client03
client04
cslocal-validator
testing

  • Try access which should not be allowed, such as viewing the contents of a data bag item or listing all nodes:

    $ knife data bag show bag1 item1 -u bootstrapclient --key bstrap.pem
ERROR: You authenticated successfully to https://chef.server.fqdn/organizations/cslocal as bootstrapclient but you are not authorized for this action.
Response:  missing read permission

    $ knife node list  -u bootstrapclient --key bstrap.pem
ERROR: You authenticated successfully to https://chef.server.fqdn/organizations/cslocal as bootstrapclient but you are not authorized for this action.
Response:  missing read permission

    $ knife data bag list  -u bootstrapclient --key bstrap.pem
ERROR: You authenticated successfully to https://chef.server.fqdn/organizations/cslocal as bootstrapclient but you are not authorized for this action.
Response:  missing read permission