Configuration

Si votre application doit être exécutée dans le gestionnaire de sécurité de Java, vous devez accorder des autorisations supplémentaires en mettant à jour un fichier de politique ou en indiquant un fichier supplémentaire ou différent au moment de l'exécution.

La trousse SDK nécessite les autorisations suivantes :

• Requises 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";

• Requise par la trousse SDK pour remplacer les en-têtes réservés :

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

• Requise par la trousse SDK pour ouvrir les connexions de connecteur logiciel :

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

Pour inclure un autre fichier de politique, en plus du fichier de politique par défaut de l'environnement d'exécution Java, lancez la machine virtuelle Java avec :

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

Pour remplacer le fichier de politique par défaut, lancez la machine virtuelle Java avec :

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

À partir de la version 2.0.0, la trousse 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 HTTP Apache 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 d'une conformité FIPS, vous devez télécharger et utiliser une version certifiée FIPS. La trousse SDK prend en charge bc-fips 1.0.2 et bcpkix-fips 1.0.3. Vous pouvez les télécharger à l'adresse : https://www.bouncycastle.org/fips-java/

Pour obtenir de l'aide pour installer et configurer Bouncy Castle FIPS, voir "Documentation sur BC FIPS" dans les Guides d'utilisateur et la politique de sécurité de la documentation sur Bouncy Castle.

Dépendances autogérées

Si vous gérez vous-même les dépendances :

1. Supprimez les fichiers jar Bouncy Castle non FIPS du chemin de classe :
   1. bcprov-jdk15on-1.60.jar
   2. bcpkix-jdk15on-1.60.jar
2. Ajoutez plutôt les fichiers jar Bouncy Castle FIPS au chemin de classe :
   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 :

La trousse SDK pour Java est groupée avec Jersey, mais vous pouvez également utiliser votre propre mise en oeuvre JAX-RS.

La connexion à la trousse SDK s'effectue au moyen de SLF4J. SLF4J est une abstraction de journalisation qui permet l'utilisation d'une bibliothèque de journalisation fournie par l'utilisateur (par exemple, log4j). Pour plus d'informations, voir le manuel SLF4J.

Voici un exemple qui permet une journalisation de base. D'autres options de journalisation avancées peuvent être configurées à l'aide de la liaison log4j.

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