Getting Started
1. Create a Pangea Account
Creating a Pangea service account is free, fast, and secure. Sign up with an existing identity provider (like Google, GitHub) or create an account with your email.
In the account creation process, you'll be asked to create an organization (top-level group) and project (individual app).
If you just created a new organization and project, you'll be redirected to a "Get started with a common service" dialog. Here, you can just click on the Skip button to get redirected to the developer console.
2. Configure Audit Log Service
In this guide, we’ll set up Pangea’s Secure Audit Log service. In the developer console, you’ll see a list of services on the left hand panel. Click on the Secure Audit Log service to enable it.
Set Up an Audit Log schema
Continue with the default Standard Audit Log schema that contains basic fields to give you an understanding of how the audit log works. In the future, you can choose from an array of general HIPAA, GDPR, PCI DSS, and other compliance templates for your schema.
Hit Next and you’ll be navigated to the next step in the configuration process.
Create a Pangea Token
In the modal, you’ll see a prompt to create a new Pangea Token or to extend an existing one. Make the election to Create a new token and click on Done on this prompt. A Pangea token will act as your API key to use Pangea Audit Log APIs and has the ability to be extended to other services.
You should be redirected to the overview page of the audit log service .
3. Create your first Audit Log Entry
Head over to the “Overview” tab on the left-hand panel of Secure Audit Log and copy the “Default Token” (AKA Pangea Token).
Now, let’s write our first log! Open up your terminal and run the following curl command after replacing the <PANGEA_TOKEN> with your Pangea Token.
Open up a terminal and install the library with pip or poetry
pip install pangea-sdk
Now that you have the Python SDK installed, you can run your first API request. Save the following code sample in a file called audit.py
import os
from pangea.config import PangeaConfig
from pangea.services import Audit
# Load client configuration from environment variables (i.e. PANGEA_TOKEN).
token = os.getenv("PANGEA_TOKEN")
config = PangeaConfig(domain="aws.us.pangea.cloud") # Update this domain if you're using an org in EU
# Create a Secure Audit Log client.
audit = Audit(token, config)
# Log a basic event.
response = audit.log(message="Hello, World!")
From the command line, cd into the directory where the file you created is located. Then run the command below with the Pangea values from the Secure Audit log overview page .
PANGEA_TOKEN="..." \
python3 audit.py
Once you see a successful API response on the right side of the page, head back to the Audit Log dashboard . Go to the View Logs tab on the left panel. Here you should see your newly created Audit Log and the message that was just sent. Additionally, you can also view details about tamperproof validation.
To learn more about other Pangea services, follow the links below: