Configuração

Se o seu aplicativo precisar ser executado no Gerenciador de Segurança do Java, você deverá conceder permissões adicionais atualizando um arquivo de política ou especificando um arquivo de política adicional ou específico durante o runtime.

O SDK requer as seguintes permissões:

• Obrigatório para Jersey:

  
  permission java.lang.RuntimePermission "getClassLoader";
  permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
  permission java.lang.RuntimePermission "accessDeclaredMembers";
  permission java.util.PropertyPermission "*", "read,write";
  permission java.lang.RuntimePermission "setFactory";

• Obrigatório para o SDK substituir cabeçalhos reservados:

  permission java.util.PropertyPermission "sun.net.http.allowRestrictedHeaders", "write";

• Obrigatório para o SDK abrir conexões de soquete:

  permission java.net.SocketPermission "*", "connect";

Para incluir outro arquivo de política, além do arquivo de política padrão do JRE (Java Runtime Environment), inicie a JVM (Java Virtual Machine) com:

java -Djava.security.manager -Djava.security.policy=</path/to/other_policy>

Para substituir o arquivo de política padrão, inicie o Java Virtual Machine com:

java -Djava.security.manager -Djava.security.policy==</path/to/other_policy>

A partir da versão 2.0.0, o SDK para Java suporta o uso do Jersey ApacheConnectorProvider em vez do Jersey padrão HttpUrlConnectorProvider para permitir que o Apache HttpClient faça chamadas de serviço do OCI.

ObjectStorageClient nonBufferingObjectStorageClient = ObjectStorageClient
        .builder()
        .clientConfigurator(builder -> {
            builder.property(JerseyClientProperties.USE_APACHE_CONNECTOR, false);
        })
        // ...
        .build(provider);

Se precisar de conformidade com o FIPS, faça download e use uma versão certificada pelo FIPS. O SDK suporta bc-fips 1.0.2 e bcpkix-fips 1.0.3. Você pode fazer o download de ambos em: https://www.bouncycastle.org/fips-java/

Para obter ajuda para instalar e configurar o Bouncy Castle FIPS, consulte a "Documentação do BC FIPS" em Guias do Usuário e Política de Segurança da Documentação do Bouncy Castle.

Dependências Autogerenciadas

Se você mesmo estiver gerenciando dependências:

1. Remova os arquivos jar não FIPS Bouncy Castle do classpath:
   1. bcprov-jdk15on-1.60.jar
   2. bcpkix-jdk15on-1.60.jar
2. Adicione os arquivos jar do FIPS Bouncy Castle ao classpath em vez disso:
   1. bc-fips-1.0.2.jar
   2. bcpkix-fips-1.0.3.jar

Dependências Gerenciadas pelo Maven

Se você estiver usando o Maven para gerenciar suas dependências:

O SDK para Java faz parte do Jersey, mas você também pode usar a sua própria implementação JAX-RS.

O registro em logs no SDK é feito por meio do SLF4J. O SLF4J é uma abstração de log que permite o uso de uma biblioteca de logs fornecida pelo usuário (por exemplo, log4j). Para obter mais informações, consulte o Manual do SLF4J.

Veja a seguir um exemplo que permite o log básico da saída padrão. Mais opções de log avançadas podem ser configuradas usando o binding do log4j.

1. Faça download do jar de binding Simples do SLF4J Binding Simples do SLF4J
2. Adicione o jar ao seu classpath (por exemplo, adicione-o ao diretório /third-party/lib do download do SDK)
3. Adicione o seguinte argumento VM para ativar o log em nível de depuração (por padrão, o nível de informações é usado): -Dorg.slf4j.simpleLogger.defaultLogLevel=debug