תחילת העבודה עם Universal Ledger

איך מצטרפים לרשת Universal Ledger ומפעילים את Universal Ledger API בפרויקטים ב- Google Cloud .

בקשת הצטרפות

כדי לשלוח עסקאות לרשת, קודם צריך ליצור חשבון Universal Ledger. כדאי לעיין בדף סקירה כללית של המוצר כדי להכיר את הסוגים השונים של חשבונות הניהול והחשבונות של המפעילים.

חשבונות Ledger צריכים להיווצר על ידי חשבון אדמין עם הרשאות ב-Ledger. כדי לשלוח את פרטי ההצטרפות הנדרשים, כדאי לעיין במדריך מי יכול ליצור את החשבון שלכם.

כדי להגדיר חשבון של מפעיל מטבעות או לדון בתרחיש לדוגמה, פנו אלינו בכתובת gcul-help@google.com.

הפעלת ה-API

אתם יכולים להפעיל את Universal Ledger API באמצעות gcloud, ולהקצות גישה מפורטת לחברי הצוות באמצעות תפקידים ספציפיים ב-IAM.

  1. הפעלת ה-API באמצעות gcloud

    כדי להפעיל את ה-API, משתמשים בפקודה gcloud services enable:

    gcloud services enable universalledger.googleapis.com \
    --project=PROJECT_ID

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את ה-API.

    אם אתם בעלי הפרויקט, עכשיו אתם יכולים לשלוח בקשות ל-API.

  2. הגדרת גישה פרטנית באמצעות תפקידי IAM

    כדי לנהל את הגישה הפרטנית של חברים אחרים בארגון ל-Universal Ledger API, אתם יכולים להקצות להם תפקידי IAM. ל-API יש שלושה תפקידי IAM מוגדרים, שכל אחד מהם מספק שכבות גישה שונות:

    • ‫roles/universalledger.viewer: גישה לקריאה בלבד לנקודות קצה ולרשתות זמינות. מאפשרת לראות את נקודות הקצה ולשלוח שאילתות לרשת באמצעות נקודת קצה.
    • ‫roles/universalledger.editor: גישה מלאה לנקודות הקצה ולרשתות הזמינות. מאפשרת לשלוח שאילתות לרשתות ולשלוח עסקאות.
    • ‫roles/universalledger.admin: גישה מלאה לנקודות הקצה ולרשתות הזמינות. מעניקה גישה לשליחת שאילתות לרשתות ולשליחת עסקאות. לתפקיד הזה יש את אותן הרשאות כמו לתפקיד "עריכה ב-Universal Ledger", אבל זה יכול להשתנות בעתיד.

    כדי להוסיף תפקיד IAM חדש למשתמש, משתמשים בפקודה gcloud projects add-iam-policy-binding:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="PRINCIPAL" \
    --role="ROLE"

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: הפרויקט שבו רוצים להוסיף את הקישור של מדיניות ה-IAM
    • ‫PRINCIPAL: חשבון המשתמש שאליו מוסיפים את התפקיד, לדוגמה: user:test-user@gmail.com או serviceAccount:test123@example.domain.com.
    • ‫ROLE: אחד מהתפקידים שתוארו קודם, שיוקצה לחשבון המשתמש

שליחת הבקשה הראשונה

עכשיו אתם יכולים להתחיל להשתמש ב-API.

כדי לוודא שההגדרה הקודמת פועלת כמו שצריך, קודם מאמתים באמצעות הפקודה gcloud auth application-default login:

gcloud auth application-default login

אחר כך מנסים לשלוח בקשת endpoints.list:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -X GET "https://universalledger.us-central1.rep.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints"

בקשות לרשת Universal Ledger נשלחות באמצעות נקודות קצה ל-API, בפורמט הבא:

https://universalledger.REGION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/endpoints/NETWORK_NAME

השלבים האלה מאמתים את הגישה שלכם ל-Universal Ledger API.

המאמרים הבאים