Credential Management
Credentials in Nappai allow you to securely connect with hundreds of different external services, from artificial intelligence platforms to productivity tools and databases. This guide will show you how to configure and manage these connections efficiently.
What Are Credentials?
Credentials are the access keys, tokens, and settings you need to connect Nappai with external services. Think of them as the “keys” that allow Nappai to access your accounts and services securely.
Supported Services
Nappai supports a wide range of services organized into different categories:
Artificial Intelligence
Connect with leading AI platforms like OpenAI, Google AI, Anthropic, and many others to access language models, image generation, voice processing, and more.
Productivity Tools
Integrate with office suites like Google Workspace, Microsoft 365, management tools like Notion, Trello, communication platforms, and many more.
Databases and Storage
Connect with relational databases, vector databases, cloud storage services, and backend-as-a-service platforms.
MCP Remote Servers
Access remote MCP (Model Context Protocol) servers that have been reviewed and validated by the NappAI team to ensure maximum compatibility and security.
How to Configure Credentials
Step 1: Access Settings
- Go to the “Credentials” section in your Nappai dashboard.
- Click on “Add New Credential”.
- Select the service you want to configure.
Step 2: Complete the Information
Depending on the service, you will need to provide different types of information:
For APIs with a Simple Key
- API Key: The key you get from the service provider.
- Name: A descriptive name to identify this credential.
For OAuth Services
- Client ID: Your application’s identifier.
- Client Secret: Your application’s secret key.
- Refresh Token: A token to automatically renew access.
For Databases
- Host: The server address.
- Port: The connection port.
- User: The database username.
- Password: The access password.
- Database Name: The name of the specific database.
Step 3: Validation and Saving
- Nappai will automatically verify that the credentials are valid.
- If the validation is successful, the credentials will be stored securely.
- You can then use these credentials in your workflows.
Credential Security
Advanced Encryption
All your credentials are stored using military-grade encryption. This means:
- Your keys are protected with advanced encryption algorithms.
- Only you can access your credentials.
- Nappai never stores credentials in plain text.
Security Best Practices
- Use Specific Keys: Create API keys dedicated solely to Nappai.
- Minimum Permissions: Configure keys with only the necessary permissions.
- Regular Rotation: Change your keys periodically.
- Monitoring: Regularly review the usage of your APIs.
Using Credentials in Flows
Automatic Assignment
When you create a workflow:
- Nappai automatically detects which services you need.
- It shows you only the relevant credentials for each component.
- It automatically assigns the correct credentials.
Reusability
- Once configured, you can use the same credential in multiple flows.
- You don’t need to reconfigure credentials for each project.
- You can have multiple credentials for the same service (e.g., different OpenAI accounts).
Managing Credentials
Editing Credentials
- Go to the “Credentials” section.
- Find the credential you want to modify.
- Click on “Edit”.
- Update the necessary information.
- Save the changes.
Deleting Credentials
- Select the credential you no longer need.
- Click on “Delete”.
- Confirm the action.
⚠️ Important: Deleting a credential will affect all flows that are using it.
Organization
- Use descriptive names for your credentials.
- Group credentials by project or purpose.
- Keep contact information up to date.
Troubleshooting
Common Errors
”Invalid Credentials”
Problem: The service rejects your API key. Solution:
- Verify that the key is correct.
- Ensure the key has the necessary permissions.
- Check if the key has expired.
”Connection Error”
Problem: Cannot connect to the service. Solution:
- Check your internet connection.
- Check if the service is experiencing issues.
- Confirm that the service URL is correct.
”Usage Limit Exceeded”
Problem: You have reached your plan’s limit. Solution:
- Check your usage on the provider’s dashboard.
- Consider upgrading your plan.
- Wait for your monthly limit to reset.
Getting Help
If you have problems with credentials:
- Consult the service provider’s documentation.
- Check the service’s status on their status page.
- Contact Nappai support if the problem persists.
Advanced Tips
Multiple Accounts
You can configure multiple credentials for the same service:
- Different accounts for different projects.
- Multiple databases for development and production.
- Separate accounts for different teams.
Development vs. Production Credentials
- Use test credentials during development.
- Switch to production credentials when you are ready.
- Keep credentials for different environments separate.
Usage Monitoring
- Regularly review your API usage.
- Set up alerts on services that allow it.
- Keep a record of which flows use which credentials.
Conclusion
Credential management in Nappai is designed to be simple, secure, and efficient. With support for hundreds of services and a robust encryption system, you can connect all your favorite services with confidence.
Always remember to follow security best practices and keep your credentials updated for an optimal experience with Nappai.