= Installing Bouncy Castle
:index-group: Unrevised
:jbake-date: 2018-12-05
:jbake-type: page
:jbake-status: published

NOTE: Licensed to the Apache Software Foundation (ASF)
under one or more contributor license agreements. See the NOTICE file
distributed with this work for additional information regarding
copyright ownership. The ASF licenses this file to you 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
. 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.

Installation of Bouncy Castle for use in TomEE itself is done in two
steps:

[arabic]
. Add the Bouncy Castle provider jar to the `$JAVA_HOME/jre/lib/ext`
directory
. Create a Bouncy Castle provider entry in the
`$JAVA_HOME/jre/lib/security/java.security` file

The entry to `java.security` will look something like the following:

[source,properties]
----
security.provider.N=org.bouncycastle.jce.provider.BouncyCastleProvider
----

Replace `N` with the order of precedence you would like to give Bouncy
Castle in comparison to the other providers in the file. *Recommended*
would be the last entry in the list -- `N` being the higest number in
the list. *Warning* that configuring Bouncy Castle as the first
provider, `security.provider.1`, may cause JVM errors.