Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

The openvpn_okta cookbook has been deprecated

Author provided reason for deprecation:

The openvpn_okta cookbook has been deprecated and is no longer being maintained by its authors. Use of the openvpn_okta cookbook is no longer recommended.


openvpn_okta (5) Versions 0.1.0

Installs/configures the OpenVPN Okta plugin

cookbook 'openvpn_okta', '= 0.1.0', :supermarket
cookbook 'openvpn_okta', '= 0.1.0'
knife supermarket install openvpn_okta
knife supermarket download openvpn_okta
Quality 50%

Openvpn_Okta Cookbook

Cookbook Version
Build Status
Code Climate
Coverage Status

A Chef cookbook for the OpenVPN Okta plugin.

Note: This cookbook installs a version of the Okta plugin built from a custom
branch that includes currently unreleased patches that add support for Okta


This cookbook depends on the openvpn and packagecloud community cookbooks,
for the OpenVPN server itself and for the packaged version of the plugin that
we build in

It primarily supports Ubuntu. There is support for RHEL platforms as well, but
the openvpn cookbook as currently released has some issues related to Systemd
that RHEL users will need to work around on their own.

It requires Chef 12.10.24+ or Chef 12 and the compat_resource cookbook.


Either add the default recipe to your node's run list or use the included
custom resource in a recipe of your own.



Ensure the OpenVPN server is installed, patch it to delay writing in the config
file and starting the service until the end of the Chef run, then install and
configure the plugin based on Chef attribbutes (below).



The Okta plugin has four possible attributes that can be set, two of which are
required for it to function.

node['openvpn_okta']['url'] (required)
node['openvpn_okta']['token'] (required)
node['openvpn_okta']['username_suffix'] (optional)
node['openvpn_okta']['allow_untrusted_users'] (optional)



The main resource for managing the plugin.


openvpn_okta 'default' do
  url ''
  token 'abc123'
  username_suffix ''
  allow_untrusted_users false
  action %i(install enable)


Action Description
:install Install the plugin package
:enable Patch the plugin into the OpenVPN server config
:remove Uninstall the plugin package
:disable Remove the plugin from the OpenVPN server config


Property Default Description
url nil The Okta URL
token nil The Okta API token
username_suffix nil A base @domain Okta user suffix
allow_untrusted_users nil Whether to allow untrusted users
action %i(install enable) Action(s) to perform


The RHEL implementation of the openvpn_okta resource.


The Ubuntu implementation of the openvpn_okta resource.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Add tests for the new feature; ensure they pass (rake)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

License & Authors

Copyright 2016, Socrata, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

packagecloud ~> 0.2
openvpn ~> 2.1

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Openvpn_Okta Cookbook CHANGELOG

v0.1.0 (2016-10-11)

  • Initial release

v0.0.1 (2016-09-19)

  • Development started

Collaborator Number Metric

0.1.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

0.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

0.1.0 passed this metric

No Binaries Metric

0.1.0 passed this metric

Testing File Metric

0.1.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

0.1.0 passed this metric