Erweiterte Nutzungstracking

Mit dem erweiterten Nutzungs-Tracking erhalten Sie Einblicke in Java-Server, die auf verwalteten Instanzen ausgeführt werden, und in Librarys, die von Ihren Java-Anwendungen mit Schwerpunkt auf Sicherheit verwendet werden, indem Sie anzeigen, ob die erkannten Librarys einige bekannte Sicherheitslücken enthalten.

Erweitertes Nutzungstraining umfasst:

  • Nach Java-Servern scannen
  • Nach Java-Librarys scannen

Nach Java-Servern scannen

Mit dieser Funktion können Sie Java-Server ermitteln, die in Ihrer Flotte ausgeführt werden. JMS kann derzeit WebLogic-, JBoss- und Tomcat-Server ermitteln. Nach der erfolgreichen Discovery finden Sie alle erkannten Java-Server im Abschnitt "Java-Server" von JMS Fleet.

OCI Cloud-Konsole

  1. Melden Sie sich bei der OCI-Konsole als Administrator an.
  2. Öffnen Sie das Navigationsmenü, klicken Sie auf Observability and Management, Flotten unter Java Management.
  3. Wählen Sie Ihre Flotte aus.
  4. Klicken Sie auf Aktionen, und wählen Sie im Menü die Option Nach Java-Servern suchen aus.
  5. Klicken Sie auf Scannen.
  6. Nachdem die Arbeitsanforderung abgeschlossen ist, klicken Sie auf den Abschnitt "Java-Server" der Flotte. Alle erkannten Java-Server müssen aufgelistet werden

OCI-CLI

  1. Führen Sie den folgenden Befehl aus: 
    oci jms java-server-usage scan --fleet-id $FLEET_OCID

    Hinweis:

    Sie können eine JSON-Liste der verwalteten Instanzen angeben, in denen der Scan mit dem zusätzlichen Parameter --managed-instance-ids ausgeführt werden soll. Andernfalls werden alle verwalteten Instanzen in der Flotte ausgewählt.

Beispiel-JSON-Payload, die vom JMS-Plug-in beim Scannen der Java-Server an das OCI-Bestandslogobjekt gesendet wurde: 

{
  "datetime": 1749559306604,
  "logContent": {
    "id": "ac26cc41-de6d-4f8a-994b-909a3705d0db",
    "time": "2025-06-10T12:41:46.604Z",
    "oracle": {
      "compartmentid": "ocid1.compartment.oc1..compartment-id",
      "ingestedtime": "2025-06-10T12:42:08.158306651Z",
      "instanceid": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
      "loggroupid": "ocid1.loggroup.oc1.eu-frankfurt-1.log-group-id",
      "logid": "ocid1.log.oc1.eu-frankfurt-1.log-id",
      "tenantid": "ocid1.tenancy.oc1..tenant-id"
    },
    "source": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
    "specversion": "1.0",
    "subject": "Oracle JMS Plugin",
    "type": "jms.javaserver.metadata.log",
    "data": {
      "data": {
        "clusterName": "",
        "committedHeap": 16252928,
        "deployments": [],
        "fleetId": "ocid1.jmsfleet.oc1.eu-frankfurt-1.fleet-id",
        "initHeap": 16777216,
        "javaDistribution": "Java(TM) SE Runtime Environment",
        "javaHome": "/usr/lib/jvm/jdk-17.0.15-oracle-x64",
        "javaMajorVersion": "17",
        "javaVendor": "Oracle Corporation",
        "javaVersion": "17.0.15",
        "managedInstanceId": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
        "maxHeap": 241303552,
        "osArch": "amd64",
        "osName": "Linux",
        "osVersion": "5.15.0-306.177.4.el9uek.x86_64",
        "productName": "Apache Tomcat",
        "productVersion": "11.0.8.0",
        "serverHome": "/home/opc/apache-tomcat-11.0.8",
        "serverName": "N/A",
        "serverPort": "8088",
        "usedHeap": 13224344
      },
      "datacontenttype": "application/json",
      "dataschema": "1.0",
      "id": "5d1178ee-f8e9-4cd4-a463-5bb309c02b99",
      "source": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
      "specversion": "1.0",
      "time": "2025-06-10T12:41:46.601Z",
      "type": "jms.javaserver.metadata.log"
    }
  },
  "regionId": "eu-frankfurt-1"
}

Nach Java-Librarys scannen

Mit dieser Funktion können Sie einen Bericht über alle Librarys erstellen, die von Ihren Java-Anwendungen in einem einzelnen Bereich Ihrer Flotte verwendet werden, der als Java-Librarys bezeichnet wird.

Sie können es zum Scannen bekannter Sicherheitslücken in Java-Bibliotheken von Drittanbietern verwenden und sicherstellen, dass keine unerwünschte Library von Ihren Java-Anwendungen verwendet wird. Ein besseres Verständnis dessen, was JMS erkennen kann oder nicht kann, finden Sie in der offiziellen Dokumentation hier: Nach Java-Librarys scannen.

OCI Cloud-Konsole

  1. Melden Sie sich bei der OCI-Konsole als Administrator an.
  2. Öffnen Sie das Navigationsmenü, klicken Sie auf Observability and Management, Flotten unter Java Management.
  3. Wählen Sie Ihre Flotte aus.
  4. Klicken Sie auf Aktionen, und wählen Sie im Menü die Option Nach Java-Librarys suchen aus.
  5. Klicken Sie auf Scannen.
  6. Klicken Sie nach Abschluss der Arbeitsanforderung auf den Abschnitt "Java-Librarys" der Flotte. Alle erkannten Java-Librarys müssen aufgelistet werden

OCI-CLI

  1. Führen Sie den folgenden Befehl aus: 
    oci jms library-usage scan --fleet-id $FLEET_OCID

    Hinweis:

    Sie können eine JSON-Liste der verwalteten Instanzen angeben, in denen der Scan mit dem zusätzlichen Parameter --managed-instance-ids ausgeführt werden soll. Andernfalls werden alle verwalteten Instanzen in der Flotte ausgewählt.

Beispiel für eine JSON-Payload, die vom JMS-Plug-in beim Scannen der Java-Librarys an das OCI-Bestandslogobjekt gesendet wurde: 

{
  "datetime": 1749633185521,
  "logContent": {
    "id": "e7915f73-ac67-4ec7-9d4d-7798cb9e0ce0",
    "time": "2025-06-11T09:13:05.521Z",
    "oracle": {
      "compartmentid": "ocid1.compartment.oc1..compartment-id",
      "ingestedtime": "2025-06-11T09:14:53.129341509Z",
      "instanceid": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
      "loggroupid": "ocid1.loggroup.oc1.eu-frankfurt-1.log-group-id",
      "logid": "ocid1.log.oc1.eu-frankfurt-1.log-id",
      "tenantid": "ocid1.tenancy.oc1..tenant-id"
    },
    "source": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
    "specversion": "1.0",
    "subject": "Oracle JMS Plugin",
    "type": "jms.javaserver.libraries.log",
    "data": {
      "data": {
        "applicationSourcePath": "/var/lib/tomcat/webapps/java-webapp-demo-0.0.1-SNAPSHOT.war",
        "clusterName": "",
        "committedHeap": 25296896,
        "deploymentName": "java-webapp-demo-0.0.1-SNAPSHOT",
        "deploymentType": "war",
        "fleetId": "ocid1.jmsfleet.oc1.eu-frankfurt-1.fleet-id",
        "initHeap": 16777216,
        "javaDistribution": "Java(TM) SE Runtime Environment",
        "javaHome": "/opt/java/jdk-24.0.1",
        "javaMajorVersion": "24",
        "javaVendor": "Oracle Corporation",
        "javaVersion": "24.0.1",
        "libraries": [
          "google llc:error_prone_annotations:2.30.0:com.google.errorprone",
          "fasterxml:jackson-datatype-jsr310:2.19.0:com.fasterxml.jackson.datatype",
          "fasterxml:jackson-core:2.19.0:com.fasterxml.jackson.core",
          "the apache software foundation:log4j-to-slf4j:2.24.3:org.apache.logging.log4j",      
          "google gson project:gson:2.13.1:com.google.code.gson",
          "slf4j.org:slf4j-api:2.0.17:org.slf4j",
          "google llc:proto-google-common-protos:2.54.1:com.google.api.grpc",
          "the apache software foundation:log4j-api:2.24.3:org.apache.logging.log4j",
          "h2 group:h2:2.3.232:n/a",
          "slf4j.org:jul-to-slf4j:2.0.17:org.slf4j",
          "qos.ch:logback-classic:1.5.18:ch.qos.logback",
          "fasterxml:jackson-annotations:2.19.0:com.fasterxml.jackson.core",    
          "fasterxml:jackson-module-parameter-names:2.19.0:com.fasterxml.jackson.module",
          "fasterxml:jackson-databind:2.19.0:com.fasterxml.jackson.core",
          "eclipse foundation:jakarta.annotation-api:2.1.1:jakarta.annotation",
          "qos.ch:logback-core:1.5.18:ch.qos.logback"
        ],
        "managedInstanceId": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
        "maxHeap": 241303552,
        "osArch": "amd64",
        "osName": "Linux",
        "osVersion": "5.15.0-306.177.4.el9uek.x86_64",
        "productName": "Apache Tomcat",
        "productVersion": "9.0.87.0",
        "serverHome": "/usr/share/tomcat",
        "serverName": "N/A",
        "serverPort": "8080",
        "usedHeap": 23623336
      },
      "datacontenttype": "application/json",
      "dataschema": "1.0",
      "id": "f725e769-aea1-4c46-9125-9bec280b75c6",
      "source": "ocid1.instance.oc1.eu-frankfurt-1.instance-id",
      "specversion": "1.0",
      "time": "2025-06-11T09:13:05.518Z",
      "type": "jms.javaserver.libraries.log"
    }
  },
  "regionId": "eu-frankfurt-1"
}

Beispiel

Stellen Sie sich vor, Sie haben eine Java-Anwendung, die von Ihrem bevorzugten Softwareanbieter entwickelt wurde, und die Anwendung wird auf einem Server bereitgestellt, der sich in Ihrer Infrastruktur befindet. Um mögliche Sicherheitsprobleme zu vermeiden, möchten Sie wissen, ob die Anwendung keine bekannten Sicherheitslücken enthält. Im folgenden Beispiel ist eine Java-Webanwendung auf einem Apache Tomcat-Server bereitgestellt. Jetzt führen wir einen Java-Library-Scan mit dem folgenden Skript aus: 
#!/usr/bin/env bash
 
# configuration variables
FLEET_OCID=ocid1.jmsfleet.oc1.eu-frankfurt-1.amaaaaaaptiaquqa2qxxkco6hrguz7nyug2hcpgikhe5gz4d7uy6j6ilbtta
MANAGED_INSTANCE_OCID=ocid1.instance.oc1.eu-frankfurt-1.antheljtptiaquqcrjmnu7mxbjthm2jm5qzryu7xy4w27rfo56nxf4uwv6pq
 
# execute library scan on specific managed instance within your fleet where example application is running
WORK_REQUEST_OCID=$(oci jms library-usage scan \
        --fleet-id "$FLEET_OCID" \
        --managed-instance-ids "[\"$MANAGED_INSTANCE_OCID\"]" | jq -r '."opc-work-request-id"')
 
echo $WORK_REQUEST_OCID
 
# additionally you can add your own logic to check if work request is finished
# sleep 600
# oci jms work-request get --work-request-id "$WORK_REQUEST_OCID" | jq .data.status

Sobald die Arbeitsanforderung abgeschlossen ist und Daten in JMS vorhanden sind, können wir mit dem folgenden Befehl prüfen, ob unsere Anwendung einige Sicherheitslücken enthält: 

#!/usr/bin/env bash
 
# configuration variables
FLEET_OCID=ocid1.jmsfleet.oc1.eu-frankfurt-1.amaaaaaaptiaquqa2qxxkco6hrguz7nyug2hcpgikhe5gz4d7uy6j6ilbtta
MANAGED_INSTANCE_OCID=ocid1.instance.oc1.eu-frankfurt-1.antheljtptiaquqcrjmnu7mxbjthm2jm5qzryu7xy4w27rfo56nxf4uwv6pq
 
# show first 1000 libraries and print those where JMS is aware of some CVE
oci jms library-usage summarize \
        --fleet-id $FLEET_OCID \
        --managed-instance-id $MANAGED_INSTANCE_OCID \
        --limit 1000 \
        --sort-by timeFirstSeen \
        --sort-order desc | jq '.data.items|map(select(."cve-id" != null))'
 
[
  {
    "approximate-application-count": 0,
    "approximate-deployed-application-count": 1,
    "approximate-java-server-instance-count": 1,
    "approximate-managed-instance-count": 1,
    "cve-id": "CVE-2021-20190",
    "cvss-score": 8.3,
    "fleet-id": "ocid1.jmsfleet.oc1.eu-frankfurt-1.amaaaaaaptiaquqa2qxxkco6hrguz7nyug2hcpgikhe5gz4d7uy6j6ilbtta",
    "library-key": "425505b8076ceac87cc479168829bd75d6a9b2a9e9a1546989b87622da59af39",
    "library-name": "jackson-databind",
    "library-version": "2.8.11.6",
    "time-end": "2025-06-16T16:14:44.233000+00:00",
    "time-first-seen": "2025-06-16T13:09:00+00:00",
    "time-last-cve-refreshed": "2025-06-15T00:00:00+00:00",
    "time-last-seen": "2025-06-16T13:09:00+00:00",
    "time-start": "2025-06-09T00:00:00+00:00"
  },
  {
    "approximate-application-count": 0,
    "approximate-deployed-application-count": 1,
    "approximate-java-server-instance-count": 1,
    "approximate-managed-instance-count": 1,
    "cve-id": "CVE-2021-36090",
    "cvss-score": 5.0,
    "fleet-id": "ocid1.jmsfleet.oc1.eu-frankfurt-1.amaaaaaaptiaquqa2qxxkco6hrguz7nyug2hcpgikhe5gz4d7uy6j6ilbtta",
    "library-key": "6cdd56d2278eec9e4c31a9c50567821a06695341957496956d5a9defcfd3dd10",
    "library-name": "commons-compress",
    "library-version": "1.20",
    "time-end": "2025-06-16T16:14:44.233000+00:00",
    "time-first-seen": "2025-06-16T13:09:00+00:00",
    "time-last-cve-refreshed": "2025-06-15T00:00:00+00:00",
    "time-last-seen": "2025-06-16T13:09:00+00:00",
    "time-start": "2025-06-09T00:00:00+00:00"
  }
]

Im obigen Beispiel wird angezeigt, dass die Anwendung von der jackson-databind-Bibliothek der Version 2.8.11.6 abhängig ist, die aufgrund von CVE-2021-20190 aktualisiert werden muss. Ähnliches Ergebnis gilt für Abhängigkeit commons-compress von Version 1.20, die Sicherheitslücke CVE-2021-36090 gemeldet hat.