h1. ERF12-2749

h2. Generic or SSL connection errors

Please see [[Proxy_communication_errors]] first for SSL or communication errors, which aren't specific to this particular proxy action.

h2. Unable to get environments from Puppet

Check /var/log/foreman-proxy/proxy.log on your puppetmaster for more details.

h2. When using Puppet's directory environments

Ensure you have foreman-proxy 1.5.2 or higher when using Puppet 3.6+ and directory environments ("environmentpath" setting).

Ensure that your @auth.conf@ enables access to the enviroments endpoint.

@path /v2.0/environments

method find

allow *@

h2. The environment must be purely alphanumeric, not 'v2.0'

    ERROR -- : Failed to list puppet environments: Failed to query Puppet find environments API (400): The environment must be purely alphanumeric, not 'v2.0'

This indicates an older version of Puppet is running that doesn't have the available API for directory environments, but the proxy is trying to use them.  Ensure Puppet is version 3.6 or higher to use directory environments (preferably 3.7 due to bugs).  If you want to use an older version, you'll need to remove "environmentpath" and use config environments: https://docs.puppetlabs.com/puppet/latest/reference/environments_classic.html