# GCP event configuration tutorial

This article steps you through configuring Google Cloud Platform (GCP) for event notification delivery. This requires you to create three things in GCP:

1. **Google Cloud project** ; A project "is a set of configuration settings that define how your app interacts with Google services and what resources it uses."

2. **GCP Pub/Sub Topic** – A Pub/Sub resource name uniquely identifies a Pub/Sub resource, such as a subscription or topic."

3. **Identity and Access Management (IAM) role** – An IAM role contains "a set of permissions that allows you to perform specific actions on Google Cloud resources. To make permissions available to principals, including users, groups, and service accounts, you grant roles to the principals".

For this tutorial, you need:

* A Google Cloud account

# Configure GCP for Pismo event notifications

1. Go to the Google Cloud website and log in to your Google account.

2. Navigate to the GCP Console.

**Select or create a project:**

1. Select the project dropdown menu to the left of the search field.

![Screen capture of the Select a project area.](https://files.readme.io/907c942-select-gcp-project.jpg "select-gcp-project.jpg")

2. Select an existing project, or click **New Project** to create a new one. If you select an existing project, skip the next two steps.

3. Enter a project name and click **Create**.

4. Select the project you just created from the **Notifications** menu or from the projects dropdown menu.

**Create a topic:**

1. Enter "topics" in the search field and press **Enter** to bring up the Topics page.

2. Click **+Create a topic**.

3. Enter a **Name** for the topic and click **Create Topic**.

![Screen capture of the Create a topic screen.](https://files.readme.io/7a08f63-create-a-topic.jpg "create-a-topic.jpg")

**To give Pismo access to your Pub/Sub Topic:**

1. After your Pub/Sub Topic is created, the following information must be sent back to Pismo:

   * The GCP Project ID
   * The GCP Pub/Sub Topic Name

   Pismo will create the necessary resources and give you a *GCP IAM Service Account ID* that you can use for uploading to your GCP Pub/Sub Topic.

2. Navigate to the GCP Pub/Sub Topic that you just created.

3. Select the **Permissions** tab, then select the **+Add Principal** button.

![Screen capture of the permissions tab.](https://files.readme.io/4bc495e-permissions-tab.jpg "permissions-tab.jpg")

4. Enter the *GCP IAM Service Account ID* in the **New principals** field.

5. Select **Pub/Sub** > **Pub/Sub Publisher** from the **Select a role** dropdown menu.

![Screen capture of the Select a role menu.](https://files.readme.io/1419fa2-add-principals.jpg "add-principals.jpg")

6. Click **Save**.