# java-libraries

**Repository Path**: mirrors_andyglick/java-libraries

## Basic Information

- **Project Name**: java-libraries
- **Description**: Cookbook containing Java LWRPs and HWRPs
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

java-libraries
==============

Description
===========

This cookbook contains LWRPs and HWRPs for handling optional
common configuration of the JVM. The LWRPs and/or libraries in
this cookbook should be referenced from recipes that run after
the installation and configuration of Java via the cookbook at
https://github.com/socrata-cookbooks/java.

Contributing
------------
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. **Add tests!**
5. Push to the branch (`git push origin my-new-feature`)
6. Create new Pull Request

Resources/Providers
===================

## `java_certificate` LWRP

This cookbook contains the `java_certificate` LWRP which simplifies
adding certificates to a java keystore. It can also populate the keystore
with a certificate retrieved from a given SSL end-point. It defaults
to the default keystore `<java_home>/jre/lib/security/cacerts` with the
default password if a specific keystore is not provided.

### Actions

- `:install`: installs a certificate.
- `:remove`: removes a certificate.

### Attribute Parameters

- `cert_alias`: The alias of the certificate in the keystore. This defaults
  to the name of the resource.

Optional parameters:
- `java_home`: the java home directory. Defaults to `node['java']['java_home']`.
- `keystore_path`: the keystore path. Defaults to `node['java']['java_home']/jre/lib/security/cacerts`.
- `keystore_passwd`: the keystore password. Defaults to 'changeit' as specified by the Java Documentation.

Only one of the following
- `cert_data`: the certificate data to install
- `cert_file`: path to a certificate file to install
- `ssl_endpoint`: an SSL end-point from which to download the certificate

### Examples

    java_certificate "Install LDAP server certificate to Java CA keystore for Jenkins" do
        cert_alias node['jenkins']['ldap']['url'][/\/\/(.*)/, 1]
        ssl_endpoint node['jenkins']['ldap']['url']
        action :install
        notifies :restart, "runit_service[jenkins]", :delayed
    end