You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit caa4bca
Browse filesBrowse the repository at this point in the historyBrowse files
docs(links): point Connector repo references at WordPress.org
`getting-started.md` installation step now links to the WordPress.org
plugin page + the WP.org direct ZIP download instead of a pinned
GitHub releases URL. The pinned-version URL had drifted to a
1.1.1.0 build; the WP.org ZIP always serves the latest stable.
`flows.md` deep-link references replace `github.com/.../blob/<sha>/...`
URLs with `plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/...`
equivalents. Line anchors re-derived against current trunk — several
symbols moved (notably `Encryption::createIdentityNonce` from L399 to
L863) and `TrustedLoginService::envelopeToUrl()` was renamed to
`envelope_to_url()`.
Copy file name to clipboardExpand all lines: docs/flows.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,7 +41,7 @@ The public key is fetched by default from the [URL defined in the `vendor/websit
41
41
42
42
### Step 3: Public Key is Generated {#step-3-public-key-is-generated}
43
43
44
-
The public key request is handled by [`\TrustedLogin\Vendor\Endpoints\PublicKey::get()`](https://github.com/trustedlogin/trustedlogin-connector/blob/aac75e18d21728155b76537f908031fc17cd562a/php/Endpoints/PublicKey.php#L20), which uses [`\TrustedLogin\Vendor\Encryption::generateKeys()`](https://github.com/trustedlogin/trustedlogin-connector/blob/aac75e18d21728155b76537f908031fc17cd562a/php/Encryption.php#L100) to generate two sets of encryption keys (`crypto_sign` and `crypto_box` key pairs) but only returns the `crypto_box` public key.
44
+
The public key request is handled by [`\TrustedLogin\Vendor\Endpoints\PublicKey::get()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Endpoints/PublicKey.php#L19), which uses [`\TrustedLogin\Vendor\Encryption::generateKeys()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Encryption.php#L222) to generate two sets of encryption keys (`crypto_sign` and `crypto_box` key pairs) but only returns the `crypto_box` public key.
45
45
46
46
### Step 4: Envelope Created & Encrypted {#step-4-envelope-created--encrypted}
47
47
@@ -81,11 +81,11 @@ The **unsuccessful** response is:
The form submits a `POST` HTTP request via AJAX that is received by the [`TrustedLogin\Vendor\AccessKeyLogin::handle()`](https://github.com/trustedlogin/trustedlogin-connector/blob/main/php/AccessKeyLogin.php#L106) method.
84
+
The form submits a `POST` HTTP request via AJAX that is received by the [`TrustedLogin\Vendor\AccessKeyLogin::handle()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/AccessKeyLogin.php#L171) method.
85
85
86
-
Receiving that request, [`TrustedLogin\Vendor\AccessKeyLogin::verifyGrantAccessRequest()`](https://github.com/trustedlogin/trustedlogin-connector/blob/main/php/AccessKeyLogin.php#L200) verifies that the nonce is valid and that the request is coming from inside the site.
86
+
Receiving that request, [`TrustedLogin\Vendor\AccessKeyLogin::verifyGrantAccessRequest()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/AccessKeyLogin.php#L305) verifies that the nonce is valid and that the request is coming from inside the site.
87
87
88
-
In addition, [`TrustedLogin\Vendor\Traits\VerifyUser::verifyUserRole()`](https://github.com/trustedlogin/trustedlogin-connector/blob/develop/php/Traits/VerifyUser.php#L17) checks to make sure the user is logged-in and has one or more of the roles that are required to access the site.
88
+
In addition, [`TrustedLogin\Vendor\Traits\VerifyUser::verifyUserRole()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Traits/VerifyUser.php#L17) checks to make sure the user is logged-in and has one or more of the roles that are required to access the site.
89
89
90
90
### Step 2: Vendor Requests List of Matching Site IDs {#step-2-vendor-requests-list-of-matching-site-ids}
91
91
@@ -129,10 +129,10 @@ An array of Secret IDs is returned. These are not the envelope itself; Secret ID
129
129
130
130
The Connector plugin uses the Secret IDs to retrieve the envelopes from the Vault.
131
131
132
-
In addition to the Bearer token, the request generates a signed nonce in [`TrustedLogin\Vendor\Encryption::createIdentityNonce()`](https://github.com/trustedlogin/trustedlogin-connector/blob/develop/php/Encryption.php#L399). The method:
132
+
In addition to the Bearer token, the request generates a signed nonce in [`TrustedLogin\Vendor\Encryption::createIdentityNonce()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Encryption.php#L863). The method:
133
133
134
-
- Generates a cryptographic nonce (in [`TrustedLogin\Vendor\Encryption::generateNonce()`](https://github.com/trustedlogin/trustedlogin-connector/blob/develop/php/Encryption.php#L485) using `random_bytes()`),
135
-
- Signs the nonce with the `sign_private_key` pair (in [`TrustedLogin\Vendor\Encryption::sign()`](https://github.com/trustedlogin/trustedlogin-connector/blob/develop/php/Encryption.php#L512), using `sodium_crypto_sign_detached()`), and
134
+
- Generates a cryptographic nonce (in [`TrustedLogin\Vendor\Encryption::generateNonce()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Encryption.php#L953) using `random_bytes()`),
135
+
- Signs the nonce with the `sign_private_key` pair (in [`TrustedLogin\Vendor\Encryption::sign()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/Encryption.php#L979), using `sodium_crypto_sign_detached()`), and
136
136
- Verifies that the signed nonce has been properly generated (using `sodium_crypto_sign_verify_detached()`)
137
137
138
138
The nonce and signed nonce are both sent in the request, helping to verify that this site is indeed the sender of the data.
@@ -155,13 +155,13 @@ The envelope with encrypted credentials is returned to the Vendor.
155
155
156
156
The Connector plugin receives the envelope. It includes the Site URL associated with the Site Access Key but not the endpoint, which is required to log in.
157
157
158
-
The Connector plugin decrypts the envelope and extracts the credentials, then cryptographically generates the URL to access Client site (using [`TrustedLogin\Vendor\TrustedLoginService::envelopeToUrl()`](https://github.com/trustedlogin/trustedlogin-connector/blob/a62ec370bb5e715eed3524bf92c77482e785d273/php/TrustedLoginService.php#L395)).
158
+
The Connector plugin decrypts the envelope and extracts the credentials, then cryptographically generates the URL to access Client site (using [`TrustedLogin\Vendor\TrustedLoginService::envelope_to_url()`](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/php/TrustedLoginService.php#L808)).
159
159
160
160
The site URL and the access parts are returned as an AJAX response, completing the request started in Step 1.
161
161
162
162
### Step 7: Connector Plugin `POST`s to Client Site {#step-7-connector-plugin-posts-to-client-site}
163
163
164
-
A temporary form [is created using JavaScript](https://github.com/trustedlogin/trustedlogin-connector/blob/a62ec370bb5e715eed3524bf92c77482e785d273/src/components/AccessKeyForm.js#L259-L281) with the Client Site URL set as the form `action` property. A `POST` request is submitted, preventing the submitted data from being logged.
164
+
A temporary form [is created using JavaScript](https://plugins.trac.wordpress.org/browser/trustedlogin-connector/trunk/src/components/AccessKeyForm.js#L253) with the Client Site URL set as the form `action` property. A `POST` request is submitted, preventing the submitted data from being logged.
165
165
166
166
The form submits the following to the Client Site URL:
Copy file name to clipboardExpand all lines: docs/getting-started.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -67,7 +67,7 @@ Don't close the tab! We'll be coming back here to grab the Account ID, Public Ke
67
67
68
68
The TrustedLogin Connector plugin is a WordPress plugin that you host on your own site. The Connector plugin is what makes TrustedLogin so secure: secrets are encrypted and decrypted using keys that are generated by the Connector plugin.
69
69
70
-
1.[Download the Connector plugin](https://github.com/trustedlogin/trustedlogin-connector/releases/download/v1.1.1.0/trustedlogin-connector-1.1.1.zip)
70
+
1.Get the plugin from the [WordPress.org plugin page](https://wordpress.org/plugins/trustedlogin-connector/) — or [download the latest ZIP directly](https://downloads.wordpress.org/plugin/trustedlogin-connector.zip)
71
71
2. Upload the plugin to your WordPress installation
72
72
3. Click the new "TrustedLogin" menu item in the sidebar menu
0 commit comments