Configuration

Si votre application doit être exécutée dans le gestionnaire de sécurité Java, vous devez accorder des droits d'accès supplémentaires en mettant à jour un fichier de stratégie, ou en indiquant un fichier de stratégie supplémentaire ou différent lors de l'exécution.

Le kit SDK exige les droits d'accès suivants :

• Requis par 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";

• Requis par le kit SDK pour écraser les en-têtes réservés :

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

• Requis par le kit SDK pour ouvrir les connexions de socket :

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

Pour inclure un autre fichier de stratégie, en plus du fichier de stratégie par défaut de l'environnement JRE, lancez la Java Virtual Machine avec ce qui suit :

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

Pour remplacer le fichier de stratégie par défaut, lancez la Java Virtual Machine avec ce qui suit :

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

A partir de la version 2.0.0, le kit SDK pour Java prend en charge l'utilisation du connecteur Jersey ApacheConnectorProvider au lieu du connecteur Jersey par défaut HttpUrlConnectorProvider pour permettre au client Apache HttpClient d'effectuer des appels de service OCI.

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

Si vous avez besoin de la conformité FIPS, vous devez télécharger et utiliser une version certifiée FIPS. Le kit SDK prend en charge bc-fips 1.0.2 et bcpkix-fips 1.0.3. Vous pouvez les télécharger à l'adresse suivante : https://www.bouncycastle.org/fips-java/

Pour obtenir de l'aide concernant l'installation et la configuration de Bouncy Castle FIPS, reportez-vous à la documentation BC FIPS dans les guides de l'utilisateur et dans la stratégie de sécurité de la documentation Bouncy Castle.

Dépendances auto-gérées

Si vous gérez vous-même les dépendances, procédez comme suit :

1. Enlevez les fichiers JAR Bouncy Castle non FIPS de la variable d'environnement CLASSPATH :
   1. bcprov-jdk15on-1.60.jar
   2. bcpkix-jdk15on-1.60.jar
2. A la place, ajoutez les fichiers JAR Bouncy Castle FIPS à la variable d'environnement CLASSPATH :
   1. bc-fips-1.0.2.jar
   2. bcpkix-fips-1.0.3.jar

Dépendances gérées par Maven

Si vous utilisez Maven pour gérer vos dépendances, procédez comme suit :

Le kit SDK pour Java est fourni avec Jersey, mais vous pouvez également utiliser votre propre implémentation JAX-RS.

La journalisation dans le kit SDK est effectuée via SLF4J. SLF4J est une abstraction de journalisation qui permet d'utiliser une bibliothèque de journalisation fournie par l'utilisateur (par exemple, log4j). Pour plus d'informations, reportez-vous au manuel de SLF4J.

Voici un exemple permettant une journalisation de base vers une sortie standard. Vous pouvez configurer des options de journalisation plus avancées à l'aide de la liaison log4j.

1. Téléchargez le fichier JAR de liaison simple SLF4J : liaison simple SLF4J.
2. Ajoutez le fichier JAR à votre variable d'environnement CLASSPATH (par exemple, ajoutez-le au répertoire /third-party/lib inclus dans le téléchargement du kit SDK).
3. Ajoutez l'argument de machine virtuelle suivant pour activer la journalisation de niveau débogage (par défaut, le niveau information est utilisé) : -Dorg.slf4j.simpleLogger.defaultLogLevel=debug.