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

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

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

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

פעולות

מידע נוסף על פעולות זמין במאמרים איך מגיבים לפעולות שממתינות לאישור ב-Your Workdesk ואיך מבצעים פעולה ידנית.

קבלת נתונים

תיאור

שליחת בקשת 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.