Using your own AWS Bedrock access keys is optional. If you don’t configure your own keys, Guardian will use Metoro’s default credentials.
Prerequisites
Before you begin, you’ll need:- An AWS account with access to AWS Bedrock
- Permissions to create IAM users and access keys
- Access to the AWS Management Console
Step 1: Create a Bedrock API Key
- Navigate to the AWS Console
- Search for and select Amazon Bedrock
- In the Bedrock console, go to API Keys section
- Click Create API Key
- Give your API key a descriptive name (e.g., “metoro-guardian-key”)
- Select the appropriate permissions and models you want to grant access to
- Click Create
When you create a Bedrock API Key, AWS automatically creates an associated IAM user. You’ll need to find this user in the next step.
Step 2: Find the Associated IAM User
After creating the Bedrock API Key:- Navigate to the IAM Console in AWS
- Click on Users in the left sidebar
- Look for the IAM user that was automatically created for your Bedrock API Key
- The user name typically follows a pattern related to your Bedrock API key name
- It may have a prefix like
Bedrock-
or contain the API key name you specified
Step 3: Create Access Keys for the IAM User
Once you’ve found the correct IAM user:- Click on the IAM user name to open the user details
- Navigate to the Security credentials tab
- Scroll down to the Access keys section
- Click Create access key
- Select Third-party service as the use case
- Add a description tag (optional but recommended, e.g., “Metoro Guardian Integration”)
- Click Create access key
Important: This is your only opportunity to view and download the access key credentials. Make sure to:
- Copy the Access key ID
- Copy the Secret access key
- Store them securely
Step 4: Configure Access Keys in Metoro
Now that you have your AWS access credentials, configure them in Metoro:Option A: During Guardian Onboarding
If you’re setting up Guardian for the first time:- During the Guardian onboarding process, you’ll reach the Access Keys step
- Enter your Access Key ID in the “Access Key” field
- Enter your Secret Access Key in the “Access Secret” field
- Click Save to store your credentials
Option B: From Settings
If Guardian is already set up or you want to update your credentials:- Navigate to Settings → AI Settings → API Keys
- In the AWS Bedrock Access Credentials section:
- Enter your Access Key ID in the “Access Key” field
- Enter your Secret Access Key in the “Access Secret” field
- Click Save to store your credentials
Your credentials are encrypted and stored securely. They are never exposed in the UI after being saved.
Managing Your Access Keys
Viewing Current Configuration
You can see if you have configured access keys by checking:- Settings → AI Settings → API Keys
- The current access key ID (not the secret) will be displayed if configured
Updating Access Keys
To update your access keys:- Go to Settings → AI Settings → API Keys
- Delete the existing key by clicking the Delete button
- Enter your new access credentials
- Click Save
Deleting Access Keys
You can remove your AWS credentials from Metoro at any time:- Go to Settings → AI Settings → API Keys
- Click the Delete button next to your current access key
- Confirm the deletion
Revoking Access in AWS
To completely revoke access, you should also delete the access key in AWS:- Go to the AWS IAM Console
- Find the IAM user associated with your Bedrock API Key
- Navigate to Security credentials
- Find the access key and click Delete
Security Best Practices
1
Use dedicated credentials
Create a separate Bedrock API Key specifically for Metoro integration rather than reusing existing credentials.
2
Rotate keys regularly
Periodically rotate your access keys by creating new ones and updating them in Metoro, then deleting the old ones.
3
Monitor usage
Regularly review AWS CloudTrail logs to monitor the usage of your Bedrock API keys.
4
Delete unused keys
If you’re no longer using Guardian or want to switch back to Metoro’s default credentials, delete your access keys from both Metoro and AWS.
Troubleshooting
Access Key Not Working
If your access keys aren’t working:- Verify the credentials: Make sure you copied the access key and secret correctly
- Check IAM permissions: Ensure the IAM user has the necessary permissions to access Bedrock
- Verify Bedrock access: Confirm your AWS account has access to the Bedrock models you need
Permission Errors
If you encounter permission errors:- Check that the IAM user has the
bedrock:InvokeModel
permission - Verify the user has access to the specific models Guardian needs
- Ensure there are no restrictive policies blocking access
Need Help?
If you’re experiencing issues setting up your AWS Bedrock access keys:- Contact our support team through your dedicated support channel
- Join our community Slack workspace and a member of our team will help you.