-
Notifications
You must be signed in to change notification settings - Fork 488
feat(integrations): Add support for Dropbox sign #4019
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
lordsarcastic
wants to merge
9
commits into
master
Choose a base branch
from
ext-696
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+150
−0
Open
Changes from 5 commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
566ed8c
feat(integrations): add Dropbox Sign OAuth integration and documentation
lordsarcastic 0d2b271
Chore: Renamed dropbox sign title
lordsarcastic a556783
Merge branch 'master' into ext-696
lordsarcastic 059507d
docs(dropbox-sign-oauth): update connection instructions and add visu…
lordsarcastic 939ebc3
Merge branch 'ext-696' of github.com:NangoHQ/nango into ext-696
lordsarcastic 89ffd37
Merge branch 'master' into ext-696
lordsarcastic e49ac2e
Merge branch 'master' into ext-696
hassan254-prog 817c96a
bring more additions
hassan254-prog 1eb6f86
Merge branch 'master' into ext-696
hassan254-prog File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
--- | ||
title: Dropbox Sign (OAuth) | ||
sidebarTitle: Dropbox Sign (OAuth) | ||
--- | ||
|
||
import Overview from "/snippets/overview.mdx" | ||
import PreBuiltTooling from "/snippets/generated/dropbox-sign-oauth/PreBuiltTooling.mdx" | ||
import PreBuiltUseCases from "/snippets/generated/dropbox-sign-oauth/PreBuiltUseCases.mdx" | ||
|
||
<Overview /> | ||
<PreBuiltTooling /> | ||
<PreBuiltUseCases /> | ||
|
||
## Access requirements | ||
| Pre-Requisites | Status | Comment| | ||
| - | - | - | | ||
| Paid dev account | ✅ Required | Free developer account available | | ||
| Paid test account | ✅ Required | Free test account available | | ||
| Partnership | ❌ Not required | | | ||
| App review | ✅ Required | Required for production use | | ||
| Security audit | ❌ Not required | | | ||
|
||
## Setup guide | ||
|
||
_No setup guide yet._ | ||
|
||
<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip> | ||
|
||
<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign-oauth.mdx)</Note> | ||
|
||
## Useful links | ||
|
||
- [OAuth Walkthrough](https://developers.hellosign.com/docs/oauth/walkthrough/) | ||
- [OAuth Overview](https://developers.hellosign.com/docs/oauth/overview/) | ||
- [App Approval Process](https://developers.hellosign.com/docs/oauth/app-approval/) | ||
- [API Documentation](https://developers.hellosign.com/docs/api/overview/) | ||
|
||
<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign-oauth.mdx)</Note> | ||
|
||
## API gotchas | ||
|
||
- Dropbox Sign requires production approval for apps using OAuth. Your app cannot be authorized or added by other users until it is approved for production. | ||
- You can test OAuth by authorizing your app from your own account while building. | ||
- The OAuth flow supports two scenarios: | ||
1. Authorization code flow - for users with existing Dropbox Sign accounts | ||
2. Account creation flow - for new users to Dropbox Sign | ||
- Access tokens are only valid for about an hour. You'll need to use the refresh token to generate new access tokens. | ||
- When creating an app, you'll need to provide: | ||
- App name | ||
- OAuth callback URL | ||
- Scopes (actions your app will be allowed to perform) | ||
|
||
<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign-oauth.mdx)</Note> | ||
|
||
## Going further | ||
|
||
<Card title="Connect to Dropbox Sign OAuth" icon="link" href="/integrations/all/dropbox-sign-oauth/connect" horizontal> | ||
Guide to connect to Dropbox Sign OAuth using Connect UI | ||
</Card> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
--- | ||
title: Dropbox Sign OAuth - How do I link my account? | ||
sidebarTitle: Dropbox Sign OAuth | ||
--- | ||
|
||
# Overview | ||
|
||
To authenticate with Dropbox Sign OAuth, you need: | ||
1. **Client ID** - A unique identifier for your application. | ||
2. **Client Secret** - A confidential key used to authenticate the identity of the application. | ||
|
||
This guide will walk you through creating an app and obtaining these credentials within Dropbox Sign. | ||
|
||
### Prerequisites: | ||
|
||
- You must have a Dropbox Sign account. | ||
|
||
### Instructions: | ||
|
||
#### Step 1: Creating an App | ||
1. Log in to your [Dropbox Sign Developer Portal](https://app.hellosign.com). | ||
2. Click on the profile icon in the top right corner and select **Settings**. | ||
3. Click on the **API** tab. | ||
4. Scroll down and click on the **Create an App** button. | ||
5. Enable **OAuth** and fill in the required information: | ||
- **App Name**: Your application's name | ||
- **OAuth Callback**: Add `https://api.nango.dev/oauth/callback` or your own callback URL from your Nango dashboard | ||
- **Scopes**: Select the actions your app needs to perform | ||
4. Click **Create App** to generate your credentials. | ||
|
||
#### Step 2: Obtaining Credentials | ||
1. After creating your app, you'll be provided with: | ||
- **Client ID** | ||
- **Client Secret** | ||
2. Make a copy of these credentials, as they will be needed when configuring your integration in Nango. The **Client Secret** will not be shown again, so ensure you store it securely. | ||
|
||
#### Step 3: App Approval | ||
1. Before your app can be used in production, it needs to be approved by Dropbox Sign. | ||
2. You can test your app by authorizing it from your own account while building. | ||
3. When ready for production, follow the [App Approval Process](https://developers.hellosign.com/docs/app-approval/overview/). | ||
|
||
#### Step 4: Enter credentials in the Connect UI | ||
|
||
Once you have your **Client ID** and **Client Secret**: | ||
1. Open the form where you need to authenticate with Dropbox Sign OAuth. | ||
2. Enter the **Client ID** and **Client Secret** in their designated fields. | ||
3. Submit the form, and you should be successfully authenticated. | ||
|
||
<img src="/integrations/all/dropbox-sign-oauth/form.png" style={{maxWidth: "450px" }}/> | ||
|
||
You are now connected to Dropbox Sign OAuth. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 42 additions & 0 deletions
42
docs-v2/snippets/generated/dropbox-sign-oauth/PreBuiltTooling.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
## Pre-built tooling | ||
<AccordionGroup> | ||
<Accordion title="✅ Authorization"> | ||
| Tools | Status | | ||
| - | - | | ||
| Pre-built authorization (OAuth) | ✅ | | ||
| Credentials auto-refresh | ✅ | | ||
| Auth parameters validation | ✅ | | ||
| Pre-built authorization UI | ✅ | | ||
| Custom authorization UI | ✅ | | ||
| End-user authorization guide | ✅ | | ||
| Expired credentials detection | ✅ | | ||
</Accordion> | ||
<Accordion title="✅ Read & write data"> | ||
| Tools | Status | | ||
| - | - | | ||
| Pre-built integrations | 🚫 (time to contribute: <48h) | | ||
| API unification | ✅ | | ||
| 2-way sync | ✅ | | ||
| Webhooks from Nango on data modifications | ✅ | | ||
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <48h) | | ||
| Proxy requests | ✅ | | ||
</Accordion> | ||
<Accordion title="✅ Observability & data quality"> | ||
| Tools | Status | | ||
| - | - | | ||
| HTTP request logging | ✅ | | ||
| End-to-type type safety | ✅ | | ||
| Data runtime validation | ✅ | | ||
| OpenTelemetry export | ✅ | | ||
| Slack alerts on errors | ✅ | | ||
| Integration status API | ✅ | | ||
</Accordion> | ||
<Accordion title="✅ Customization"> | ||
| Tools | Status | | ||
| - | - | | ||
| Create or customize use-cases | ✅ | | ||
| Pre-configured pagination | 🚫 (time to contribute: <48h) | | ||
| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) | | ||
| Per-customer configurations | ✅ | | ||
</Accordion> | ||
</AccordionGroup> |
5 changes: 5 additions & 0 deletions
5
docs-v2/snippets/generated/dropbox-sign-oauth/PreBuiltUseCases.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
## Pre-built integrations | ||
|
||
_No pre-built integration yet (time to contribute: <48h)_ | ||
|
||
<Tip>Not seeing the integration you need? [Build your own](https://docs.nango.dev/guides/custom-integrations/overview) independently.</Tip> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
6 changes: 6 additions & 0 deletions
6
packages/webapp/public/images/template-logos/dropbox-sign-oauth.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.