Awdurdodi Widget
Mae widgets Legalesign yn gydrannau awdurdodedig. Maent yn gwneud galwadau API Legalesign yn fewnol, felly mae’n rhaid i’ch cais pasio tocyn i’r widget cyn y gall weithio.
Mae’ch cefn gweinydd yn cynhyrchu’r tocyn. Dim ond y tocyn bychain y mae'r porwr yn ei derbyn sydd ei angen ar y widget.
Dulliau Tocyn
Mae pedwar ffordd i gyflenwi tocyn i widget:
| Dull | Sut mae’n gweithio | Yn addas ar gyfer |
|---|---|---|
| JWT SRP yn uniongyrchol | Mae’ch gweinydd yn awdurdodi gyda SRP ac yn pasio’r tocyn mynediad JWT’n uniongyrchol i briodwedd token y widget | Integreiddiadau sydd eisoes yn defnyddio SRP ac nad oes eu hangen tocyn sydd wedi’i gyfyngu |
| Tocyn cydran GraphQL (allwedd API) | Mae’ch gweinydd yn galw generateComponentToken gyda allwedd API, ac yna’n pasio’r tocyn byr a dderbynnir i’r widget | Integreiddiadau ar gyfer widgets yn unig nad ydynt yn defnyddio SRP |
| Tocyn cydran GraphQL (SRP) | Mae’ch gweinydd yn galw generateComponentToken gyda JWT SRP, ac yna’n pasio’r tocyn byr a dderbynnir i’r widget | Integreiddiadau SRP sy’n dymuno tocyn widget byr a wedi’i gyfyngu |
| REST API | Mae’ch gweinydd yn galw diweddpwynt component-token REST gyda allwedd API | Integreiddiadau REST yn unig nad ydynt yn defnyddio GraphQL |
Mae newidyn generateComponentToken GraphQL yn cefnogi awdurdodiad allwedd API a SRP yn y naill ffordd neu’r llall. Mae diweddpwyntiau REST ar gyfer allweddi API yn unig.
Peidiwch byth â datgelu allweddi API neu gymwysterau SRP yn god y porwr. Rhaid i gynhyrchu tocynnau ddigwydd ar ochr y gweinydd.
Opsiynau Tocyn yn ôl Widget
| Widget | GraphQL | REST | Yn dychwelyd |
|---|---|---|---|
| Document Viewer | generateComponentToken(input: { component: LS_DOCUMENT_VIEWER }) | GET /templatepdf/{pdfId}/component-token/ | token, expiresIn, expiresAt |
| Signer | generateComponentToken(input: { component: LS_SIGNER, signer: { recipientId } }) | GET /signer/{signerId}/component-token/ | token, sessionId, expiresIn, expiresAt |
Disgwylir i’r tocyn bara tua awr. Defnyddiwch expiresIn neu expiresAt o’r ymateb i benderfynu pryd i ail-ffresynu — peidiwch â chodio’r hyd yn sefydlog.
Perthnasol
- Document Viewer — yn cynnwys enghreifftiau tocyn mewn llinyn (GraphQL a REST)
- Signer — yn cynnwys enghreifftiau tocyn mewn llinyn (GraphQL a REST)
- generateComponentToken
- REST: Get PDF template component token
- REST: Get signer component token
- ComponentToken
- Authenticate with the GraphQL API