Πιστοποίηση με το API
Το GraphQL υποστηρίζει δύο τρόπους πιστοποίησης:
| Τρόπος | Κάλυψη | Επικεφαλίδα | Καλύτερο για |
|---|---|---|---|
| SRP | Ολόκληρο το σχήμα GraphQL | Authorization: Bearer <access-token> | Ολοκληρωμένες ενσωματώσεις |
| API Key | Μόνο υποστηριζόμενο υποσύνολο | Authorization: Bearer <api-key> | Αυτοματισμός πλευράς διακομιστή και κοινά σενάρια αποστολής/ανάγνωσης |
Η μέθοδος SRP είναι η πλήρους σχήματος μέθοδος πιστοποίησης. Τα κλειδιά API που δημιουργούνται στο Developer Portal μπορούν να έχουν πρόσβαση σε υποσύνολο υποστηριζόμενων ενεργειών GraphQL.
Πιστοποίηση με API Key
Δημιουργήστε ένα API key με ενεργοποιημένο το GraphQL στο Developer Portal, και μετά στείλτε το ως bearer token:
POST /graphql HTTP/1.1
Host: graphql.uk.legalesign.com
Content-Type: application/json
Authorization: Bearer ak_<environment>_<key-id>.<secret>
{"query": "{ user { id email } }"}
Ελέγξτε το API-key GraphQL reference και τα σήματα πιστοποίησης στις σελίδες αναφοράς query και mutation πριν χρησιμοποιήσετε μια ενέργεια με API key.
Εξουσιοδότηση Widget και Component
Τα πιστοποιημένα widgets, όπως ο Document Viewer, χρειάζονται ένα token που περνά στη token ιδιότητά τους.
Υπάρχουν δύο υποστηριζόμενοι τρόποι πλευράς διακομιστή για να παρέχετε αυτό το token:
| Πηγή token | Πώς λειτουργεί |
|---|---|
| SRP JWT | Ο διακομιστής σας χρησιμοποιεί SRP για να λάβει ένα JWT access token και το περνά στο widget |
| Component token | Ο διακομιστής σας χρησιμοποιεί ένα API key για να καλέσει το generateComponentToken, και στη συνέχεια περνά το επιστρεφόμενο token στο widget |
Το generateComponentToken είναι μόνο για API key και επιστρέφει ένα βραχυπρόθεσμο token για widgets. Το SRP παραμένει η επιλογή πλήρους σχήματος όταν το backend σας πρέπει να παρέχει απευθείας ένα JWT.
Δείτε το Widget Authorization για τη πλήρη ροή component token και οδηγίες ασφάλειας για browsers.
Πιστοποίηση SRP
Χρησιμοποιήστε SRP όταν χρειάζεστε πλήρη πρόσβαση στο σχήμα GraphQL.
API Credentials
Για να χρησιμοποιήσετε πιστοποίηση SRP, επικοινωνήστε με την Legalesign υποστήριξη για να λάβετε τα διαπιστευτήρια και τις λεπτομέρειες για την ενσωμάτωσή σας.