Configuring a Camera Trap in EarthRanger

To set up a camera trap in EarthRanger, follow these four steps:

1. Create a DAS Configuration Application
2. Create a User
3. Create a Long-Lived Token
4. Create a Camera Trap Event Type

1. Creating a DAS Configuration Application

1. Log in to your EarthRanger administration page at http://<yourorganization>.pamdas.org/admin.
2. Navigate to Home > DAS Configuration > Applications and select Add Application.
3. Configure the following settings on the Add application page:
   • Redirect URIs: Leave blank.
   • Post logout redirect uris: Leave blank
   • Client Type: Set to Confidential.
   • Authorization grant type: Set to Client Credentials.
   • Name: Enter a descriptive name for the device group (e.g., Panthera).
   • Skip Authorization: Check this box.
   • User: Leave blank.
4. Select Save

2. Creating a User

1. Go to Home > User Accounts > Users and select Add User.
2. Configure the following fields on the Add user page, filling out the form from top to bottom:
   • First Name: Enter the camera brand name (e.g., Panthera).
   • Last Name: Enter Cameras.
   • Username: Choose a descriptive username (e.g., pantheracams) and save it for reference in Step 3.
   • Permissions: Set to None.
   • Active: Check this box.
3. Select Save.

3. Creating a Long-Lived Token (Updated)

1. Go to Home > DAS Configuration > DAS Access Tokens.
2. Prepare a unique alphanumeric string, up to 40 characters, to use as a token (e.g., A1B2C3D4E5F6G7h8i9j0k1l2m3n4o5). Save this token for configuring the DAS.
3. Select Add Access Token.
4. Enter the unique token from Step 2in the Token field.
5. In Expires, choose a date far in the future to prevent the token from expiring (e.g., 2099-01-01).
6. Set the Scope to read and write.
7. Select the username, and its UUID will appear in the User field.
8. Click the magnifying glass icon next to User and search for the username created in Step 2 (e.g., pantheracams).
9. Under Application, select the application created in Step 1.
10. Select Save.

4. Creating a Camera Trap Event Type

1. Navigate to Home > Activity > Event Types and select Add Event Type.
2. Configure the following fields on the Add event type page:
   • Display: Enter the display name for the event (e.g., Camera Trap).
   • Value: Enter cameratrap_rep (ensure the value is entered exactly as shown).
   • Category: Select an appropriate category from the dropdown.
   • Schema: Paste the JSON schema provided below, replacing placeholder titles with actual values as needed.
3. Select Save.

Schema: 

{
"schema": {
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Camera Trap Event Schema",
"type": "object",
"properties": {
"cameratraprep_camera-name": {
"type": "string",
"title": "Camera Name"
},
"cameratraprep_camera-make": {
"type": "string",
"title": "Camera Make"
},
"cameratraprep_camera-version": {
"type": "string",
"title": "Camera Version"
}
}
},
"definition": [
{
"key": "cameratraprep_camera-name",
"htmlClass": "col-lg-6"
},
{
"key": "cameratraprep_camera-make",
"htmlClass": "col-lg-6"
},
{
"key": "cameratraprep_camera-version",
"htmlClass": "col-lg-6"
}
]
}