‫HTTP API בארכיטקטורת REST

גרסת השילוב: 10.0

הגדרת שילוב של API בארכיטקטורת REST ב-Google Security Operations

הוראות מפורטות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

קבלת נתונים

תיאור

שליחת בקשת HTTP וקבלת תגובה.

פרמטרים

פרמטרים	סוג	ערך ברירת המחדל	חובה	תיאור
כתובת URL	String	לא רלוונטי	כן	כתובת ה-URL שאליה תישלח הבקשה.
שם משתמש	String	לא רלוונטי	לא	לא רלוונטי
סיסמה	String	לא רלוונטי	לא	לא רלוונטי
אימות SSL	תיבת סימון	התיבה לא מסומנת	לא	אם לאמת את אישור ה-SSL של שרת היעד.
כותרות JSON	String	לא רלוונטי	לא	אובייקט JSON של כותרות ה-HTTP שיישלחו עם הבקשה.
התעלמות מקודי שגיאה של HTTP	תיבת סימון	התיבה לא מסומנת	לא	אם האפשרות מופעלת, הפעולה צריכה להתעלם מקודי שגיאה 4xx או 5xx של HTTP ולא להחזיר שגיאה.

תרחישים לדוגמה

לא רלוונטי

ריצה

הפעולה הזו פועלת על ישות כתובת ה-URL.

תוצאות הפעולה

העשרת ישויות

לא רלוונטי

תובנות

לא רלוונטי

תוצאת הסקריפט

שם תוצאת הסקריפט	אפשרויות של ערכים	דוגמה
response_data	לא רלוונטי	לא רלוונטי

תוצאת JSON

{
  "redirects": [
    "http://blank.org/"
  ],
  "response_code": 200,
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

קבלת נתוני כתובת URL

תיאור

שליחת בקשות HTTP GET לישויות של כתובות URL.

פרמטרים

פרמטרים	סוג	ערך ברירת המחדל	חובה	תיאור
שם משתמש	String	לא רלוונטי	לא	שם משתמש לאימות בסיסי. זה שינוי אופציונלי.
סיסמה	String	לא רלוונטי	לא	סיסמה לאימות בסיסי. זה שינוי אופציונלי.
אימות SSL	תיבת סימון	לא רלוונטי	לא	אם לאמת את אישור ה-SSL של שרת היעד.

תרחישים לדוגמה

לא רלוונטי

ריצה

הפעולה הזו פועלת על ישות כתובת ה-URL.

תוצאות הפעולה

העשרת ישויות

לא רלוונטי

תובנות

לא רלוונטי

תוצאת הסקריפט

שם תוצאת הסקריפט	אפשרויות של ערכים	דוגמה
is_success	נכון/לא נכון	is_success:False

תוצאת JSON

[
    {
        "EntityResult": {
            "redirects": ["http://blank.org/"],
            "data": "<html>\\n\\n<head>\\n<title>\\nblank\\n</title>\\n</head>\\n\\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<center>\\n<a style=\\\"text-decoration:none\\\" href=\\\"blank.html\\\">.</a>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n</center>\\n</body>\\n</html>\\n"
        },
        "Entity": "http://blank.org/"
    }
]

פינג

תיאור

בדיקת הקישוריות.

פרמטרים

לא רלוונטי

תרחישים לדוגמה

לא רלוונטי

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

העשרת ישויות

לא רלוונטי

תובנות

לא רלוונטי

תוצאת הסקריפט

שם תוצאת הסקריפט	אפשרויות של ערכים	דוגמה
is_succeed	נכון/לא נכון	is_succeed:False

תוצאת JSON

N/A

נתוני POST

תיאור

לשלוח בקשות HTTP ובקשות POST.

פרמטרים

פרמטר	סוג	ערך ברירת המחדל	תיאור
כתובת URL	String	לא רלוונטי	כן	כתובת ה-URL שאליה תישלח הבקשה.
נתונים	String	לא רלוונטי	כן	הנתונים שצריך לשלוח עם הבקשה.
שם משתמש	String	לא רלוונטי	לא	לא רלוונטי
סיסמה	String	לא רלוונטי	לא	לא רלוונטי
אימות SSL	תיבת סימון	לא רלוונטי	התיבה לא מסומנת	אם לאמת את אישור ה-SSL של שרת היעד.
כותרות JSON	String	לא רלוונטי	לא	אובייקט JSON של כותרות ה-HTTP שיישלחו עם הבקשה.
סוג התוכן	String	לא רלוונטי	לא	סוג התוכן. אם מגדירים את הערך application או JSON, נתוני הקלט חייבים להיות מחרוזת JSON.

תרחישים לדוגמה

לא רלוונטי

ריצה

הפעולה הזו פועלת בכל הישויות.

תוצאות הפעולה

העשרת ישויות

לא רלוונטי

תובנות

לא רלוונטי

תוצאת הסקריפט

שם תוצאת הסקריפט	אפשרויות של ערכים	דוגמה
response_data	לא רלוונטי	לא רלוונטי

תוצאת JSON

{
  "redirects": [
    "http://blank.org/"
  ],
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.