REST Resource: organizations.sources.findings

Ressource: Erkenntnis

Security Command Center-Ergebnis

Ein Ergebnis ist ein Datensatz von Bewertungsdaten (Sicherheit, Risiko, Zustand oder Datenschutz), die in Security Command Center für Darstellung, Benachrichtigung, Analyse, Richtlinientests und Durchsetzung aufgenommen werden. Eine XSS-Sicherheitslücke in einer App Engine-Anwendung ist beispielsweise ein Ergebnis.

JSON-Darstellung 
{
  "name": string,
  "parent": string,
  "resourceName": string,
  "state": enum (State),
  "category": string,
  "externalUri": string,
  "sourceProperties": {
    string: value,
    ...
  },
  "securityMarks": {
    object (SecurityMarks)
  },
  "eventTime": string,
  "createTime": string
}
Felder
name

string

Der relative Ressourcenname dieser Feststellung. Weitere Informationen finden Sie unter https://cloud.google.com/apis/design/resource_names#relative_resource_name. Beispiel: „organizations/{organization_id}/sources/{source_id}/findings/{findingId}“
parent

string

Nicht veränderbar. Der relative Ressourcenname der Quelle, zu der der Hinweis gehört. Weitere Informationen finden Sie unter https://cloud.google.com/apis/design/resource_names#relative_resource_name. Dieses Feld ist nach der Erstellung unveränderlich. Beispiel: „organizations/{organization_id}/sources/{source_id}“
resourceName

string

Bei Ergebnissen zu Google Cloud-Ressourcen der vollständige Ressourcenname der Google Cloud-Ressource, auf die sich das Ergebnis bezieht. Weitere Informationen finden Sie unter https://cloud.google.com/apis/design/resource_names#full_resource_name. Wenn sich der Hinweis auf eine nicht zu Google Cloud gehörende Ressource bezieht, kann „resourceName“ ein von einem Kunden oder Partner definierter String sein. Dieses Feld ist nach der Erstellung unveränderlich.
state

enum (State)

Der Status des Befunds.
category

string

Die zusätzliche Taxonomiegruppe in den Ergebnissen einer bestimmten Quelle. Dieses Feld ist nach der Erstellung unveränderlich. Beispiel: „XSS_FLASH_INJECTION“
externalUri

string

Der URI, der gegebenenfalls auf eine Webseite außerhalb von Security Command Center verweist, auf der zusätzliche Informationen zum Ergebnis zu finden sind. Dieses Feld ist garantiert entweder leer oder eine korrekt formatierte URL.
sourceProperties

map (key: string, value: value (Value format))

Quellspezifische Properties. Diese Eigenschaften werden von der Quelle verwaltet, die den Hinweis schreibt. Die Schlüsselnamen in der Zuordnung „sourceProperties“ müssen zwischen 1 und 255 Zeichen lang sein und mit einem Buchstaben beginnen. Sie dürfen nur alphanumerische Zeichen oder Unterstriche enthalten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityMarks

object (SecurityMarks)

Nur Ausgabe. Vom Nutzer angegebene Sicherheitsmarkierungen. Diese Markierungen werden vollständig vom Nutzer verwaltet und stammen aus der SecurityMarks-Ressource, die zum Ergebnis gehört.
eventTime

string (Timestamp format)

Die Zeit, zu der das Ereignis aufgetreten ist, oder die Zeit, zu der eine Aktualisierung des Ergebnisses erfolgt ist. Wenn das Ergebnis beispielsweise eine offene Firewall darstellt, wird der Zeitpunkt erfasst, zu dem der Detektor der Meinung ist, dass die Firewall geöffnet ist. Die Genauigkeit wird vom Detektor bestimmt. Wenn das Ergebnis später behoben wird, gibt dieser Zeitpunkt an, wann das Ergebnis behoben wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

Die Zeit, zu der das Ergebnis im Security Command Center erstellt wurde.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Bundesland

Der Status des Befunds.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
ACTIVE Die Abweichung erfordert Aufmerksamkeit und wurde noch nicht behoben.
INACTIVE Das Problem wurde behoben, als nicht relevant eingestuft oder anderweitig behoben und ist nicht mehr aktiv.

SecurityMarks

Vom Nutzer angegebene Sicherheitsmarkierungen, die an die übergeordnete Security Command Center-Ressource angehängt sind. Sicherheitsmarkierungen gelten für eine Security Command Center-Organisation. Sie können von allen Nutzern geändert und angesehen werden, die die entsprechenden Berechtigungen für die Organisation haben.

JSON-Darstellung 
{
  "name": string,
  "marks": {
    string: string,
    ...
  }
}
Felder
name

string

Der relative Ressourcenname der Sicherheitskennzeichen. Weitere Informationen finden Sie unter https://cloud.google.com/apis/design/resource_names#relative_resource_name. Beispiele: „organizations/{organization_id}/assets/{asset_id}/securityMarks“ und „organizations/{organization_id}/sources/{source_id}/findings/{findingId}/securityMarks“.
marks

map (key: string, value: string)

Veränderliche, vom Nutzer angegebene Sicherheitskennzeichen, die zur übergeordneten Ressource gehören. Es gelten folgende Einschränkungen:

  • Bei Schlüsseln und Werten wird die Groß- und Kleinschreibung nicht berücksichtigt.
  • Schlüssel müssen zwischen 1 und 256 Zeichen (einschließlich) lang sein.
  • Schlüssel müssen Buchstaben, Ziffern, Unterstriche oder Bindestriche enthalten
  • Anführende und abschließende Leerzeichen werden aus den Werten entfernt. Die verbleibenden Zeichen müssen zwischen 1 und 4.096 Zeichen (einschließlich) lang sein.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Methoden

create

 Erstellt ein Ergebnis.

group

 Hiermit werden die Ergebnisse einer Organisation oder Quelle gefiltert und nach den angegebenen Attributen gruppiert.

list

 Hier werden die Ergebnisse einer Organisation oder Quelle aufgeführt.

patch

 Erstellt oder aktualisiert einen Befund.

setState

 Aktualisiert den Status eines Ergebnisses.

updateSecurityMarks

 Aktualisiert Sicherheitsmarkierungen.