# Sisense / Periscope (beta)

## Before you start

To connect Periscope to Select Star, you will need...

* Active Periscope Account email and password credentials or Google Account credentials, for Google SSO-enabled accounts
* To calculate lineage and popularity based on the last 90 days of users' activity, you'll need to connect Select Star to the Data Warehouse that your Periscope instance is using to run queries.
* To calculate popularity and top users, Select Star requires a mapping of periscope users to their email addresses, you'll need to prepare a CSV file with a `user name: email` mapping.

Complete all of the following steps to see Periscope metadata, lineage, and popularity in Select Star.

1. [Create an Account Authentication Token](#1.-create-an-account-authentication-token) (optional, only if you're using Google Single Sign-On)
2. [Connect Periscope to Select Star](#2.-connect-periscope-to-select-star)
3. [Import User Catalog](#3.-import-user-catalog)

## 1. Create an Account Authentication Token

**Optional, only for Google SSO-enabled accounts**

Prepare your Google Account credentials and contact Select Star support to help you with the setup process.

After completing the procedure, you should receive a file named `periscope-credentials.json`. Please save it, as you will need this file in [step 2](#2.-connect-periscope-to-select-star).

## 2. Connect Periscope to Select Star

Go to the Select Star `Settings`. Click `Data` in the sidebar, then `+ Add` to create a new Data Source.

![](/files/jufHHtK9m7TEJCX480a7)

Choose `Sisense/Periscope` in the Source Type dropdown and provide the following information:

For email / password authentication please leave the default `Email and Password Credentials` checked. If your account uses Google SSO to authenticate, check `Cookies json`.

### Email and Password

![](/files/5JkTFxKRQO76qqVZTMTE)

* **Display Name:** This value is `Sisense / Periscope` by default, but you can override it if desired.
* **Email:** Your Periscope Account email
* **Password:** Your Periscope Account password
* **DB Connection:** The database you are running Periscope on top of.
* **DB Username:** The name of the service account user that runs Periscope queries in your DB Connection. It is not a Select Star service account. This is used to identify which queries Periscope runs so that Select Star can generate lineage between the database and Periscope.

### Google SSO Authentication

![](/files/aR9wi8rjpIpyCg3c4MJ6)

* **Display Name:** This value is `Sisense / Periscope` by default, but you can override it if desired.
* **Google Auth credentials JSON file:** The `periscope-credentials.json` file created in [step 1](#1.-create-an-account-authentication-token).
* **DB Connection:** The database you are running Periscope on top of.
* **DB Username:** The name of the service account user that runs Periscope queries in your DB Connection. It is not a Select Star service account. This is used to identify which queries Periscope runs so that Select Star can generate lineage between the database and Periscope.

Click the `Connect` button.

Your metadata should start loading automatically. Please allow 24-48 hours to completely generate popularity and lineage.

When the sync is complete, you'll be able to explore Periscope in Select Star.

## 3. Import User Catalog

{% hint style="info" %}
Although this step is optional, you won't see popularity / top users unless the catalog is imported.
{% endhint %}

To complete the import, please prepare a CSV file with at least the following columns:

* First Name
* Last Name
* Email

Alternatively:

* Full Name
* Email

and then contact Select Star support, <support@getselectstar.com> to do the import for you.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.selectstar.com/integrations/periscope.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.