# Source: https://docs.snyk.io/discover-snyk/getting-started.md

# Getting started

{% hint style="info" %}
Ensure you use languages, package managers, and frameworks supported by Snyk. See [Supported languages, package managers, and frameworks](https://docs.snyk.io/supported-languages/supported-languages-package-managers-and-frameworks).
{% endhint %}

## Supported browsers

{% hint style="info" %}
Snyk does not support Microsoft Internet Explorer.
{% endhint %}

Snyk supports the latest versions of the following web browsers:

* [Chrome](https://www.google.com/chrome/)
* [Edge](https://www.microsoft.com/en-us/edge?form=MA13FJ)
* [Firefox](https://www.mozilla.org/en-US/firefox/new/)
* [Safari](https://www.apple.com/safari/) (except for [Opening Fix PR](https://docs.snyk.io/scan-with-snyk/pull-requests/snyk-pull-or-merge-requests))

{% hint style="info" %}
Snyk requires Javascript to be enabled on your browser.
{% endhint %}

To start performing basic tasks in the Snyk application:

## Create or log in to a Snyk account

To create a free account or sign up for a pricing plan, navigate to [snyk.io](https://snyk.io/). For details, see [Snyk Pricing Plans](https://docs.snyk.io/implementation-and-setup/enterprise-implementation-guide/trial-limitations).

If your company has an existing Snyk account and uses single sign-on (SSO), use the SSO link provided by your administrators.

If your company requires an invitation to use Snyk, when you log in for the first time, you may see a list of Organizations, which in Snyk control access to Projects. To request access to an Organization, select the name of an Organization Admin in order to request access.

{% hint style="info" %}
If you log in with a different authentication provider from the one your company uses for the Snyk account, you create a new account. You will not be logged in to the correct Organization for your company.
{% endhint %}

When you log in to the Snyk Web UI, Snyk shows your preferred (default) Organization. Snyk also uses the settings for your preferred Organization when you test a Project locally using the CLI.

## Set up a Snyk integration

For Snyk to know where to scan, you must provide it with access to your environment. The type of integration you need depends on what systems you use, what you want to scan, and where you want to add the integrations - [Organization](https://docs.snyk.io/integrations/integrate-with-snyk) or [Group](https://docs.snyk.io/integrations/integrate-with-snyk). For information about available integrators, see [Snyk SCM integrations](https://docs.snyk.io/developer-tools/scm-integrations/organization-level-integrations) and [Integrate with Snyk](https://docs.snyk.io/integrations/integrate-with-snyk).

To scan your code, you must first integrate Snyk with the repository holding that code.

### Guided process

After creating a Snyk account, you can follow the optional getting-started walkthrough prompts to provide information and help Snyk guide your experience. This includes choosing an integration method, setting access permissions, configuring automation settings, and authenticating that integration.

Alternatively, if you want to scan your code without authenticating to your source code repository, you can select the CLI integration. This allows you to run scans from your local machine and upload results to your Organization in Snyk.

### Manual process

You can add an integration to Snyk manually at any point from the Snyk Web UI. To do this, navigate to **Integrations** > **Source Control**. For more information, see [Integrate with Snyk](https://docs.snyk.io/integrations/integrate-with-snyk).

{% hint style="info" %}
If an integration is already configured for your Organization, it is marked as **Configured**.
{% endhint %}

## Obtain and use your Snyk API token

{% hint style="warning" %}
Before authenticating, be sure you have set your region properly. For details, see [Regional hosting and data residency](https://docs.snyk.io/snyk-data-and-governance/regional-hosting-and-data-residency), which has the [list of regional URLs](https://docs.snyk.io/snyk-data-and-governance/regional-hosting-and-data-residency#regional-urls).
{% endhint %}

Your Snyk API token is a personal token available under your user profile. The Snyk API token is associated with your Snyk Account and not with a specific Organization.

Free and Team plan and trial users have access only to this personal token under the user profile. The personal token can be used to authenticate with the Snyk CLI running on a local or a build machine and an IDE when you are setting a token manually. Use a personal token with caution if you are authenticating for CI/CD or with the API, which is available for Enterprise plan users only.

To obtain your personal Snyk API token:

1. Log in to Snyk and navigate to your personal account settings.
2. In your **General** settings, under API Token, select **click to show**.
3. Highlight and copy your API key.

If you want a new API token, select **Revoke & Regenerate**, but be aware that this will make the previous API token invalid.

For information on when to use an API token and when to use a service account token, available to Enterprise plan users only, see [Authentication for API](https://docs.snyk.io/snyk-api/authentication-for-api).

## Import a Project to scan and identify issues

Snyk Projects are items that Snyk scans for issues, for example, a manifest file listing your open-source dependencies.

When you import a Project, Snyk scans that imported Project, and displays the results for you to review.

Importing a Project also does the following:

* Sets Snyk to run a regular scan on that Project for issues. See [Usage settings](https://docs.snyk.io/snyk-platform-administration/groups-and-organizations/usage-settings).
* Initiates some automation, especially default Snyk tests on pull and merge requests, which help prevent vulnerabilities from being added to the Project. This automation fails builds according to your conditions and can be disabled or customized in your [integration settings](https://docs.snyk.io/developer-tools/scm-integrations/organization-level-integrations).

## Set up Snyk Essentials

{% hint style="info" %}
Snyk Essentials is available only with Enterprise plans. For more information, see [plans and pricing](https://snyk.io/plans/).
{% endhint %}

Snyk Essentials enables Application Security teams to implement, manage, and scale a modern, high-performing, developer security program. It covers use cases under Application Security Posture Management (ASPM).

For more information, see [Snyk Essentials](https://docs.snyk.io/scan-with-snyk/snyk-essentials).

## Review results and fix your issues

After you have imported a Project, and Snyk has scanned that Project for issues, you can view the results of your scan and take action to fix issues. You can see the number of issues found, grouped by severity level (**C**ritical, **H**igh, **M**edium or **L**ow). For details, see [Severity levels](https://docs.snyk.io/manage-risk/prioritize-issues-for-fixing/severity-levels).

The scan results and available actions depend on the type of Project you scan:

* Open-source libraries: see [Snyk Open Source](https://docs.snyk.io/scan-with-snyk/snyk-open-source).
* Application code: see [Snyk Code](https://docs.snyk.io/scan-with-snyk/snyk-code).
* Container images: see [Snyk Container](https://docs.snyk.io/scan-with-snyk/snyk-container/scan-container-images).
* Infrastructure as Code (IaC), Kubernetes, Helm and Terraform configuration files and cloud misconfigurations: see [Snyk IaC](https://docs.snyk.io/scan-with-snyk/snyk-iac).