# ⏰ Getting started

## Introduction

<p class="callout success">Soffid provides the connectors needed to provision accounts on the most widely used systems. To set up this connection it is necessary a specific connector addon that you must install and configure in the Soffid console.</p>

First of all, yo must download the specific connector for your system, then install it in the Soffid console, and finally configure an agent in the Soffid console.

### Download

The <span style="color: #34b4c7;">**open-source connectors**</span> available for Soffid IAM can be found on the project website [http://www.soffid.com/download](http://www.soffid.com/download) in the Connectors section.

To download <span style="color: #34b4c7;">**enterprise connectors**</span> from [http://download.soffid.com/download/enterprise/](http://download.soffid.com/download/enterprise/) a Soffid user with authorization is required to access this functionality.

### Installation

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">1.</span> Once the connector is downloaded, please log in to IAM Console.

<p class="callout info">You need to be an administrator user of the Soffid console or a user with permission to upload addons.</p>

<p class="callout info">It is recommended to upload the addons to the master, this is the way to maintain updated all, master and tenants if there are.</p>

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">2.</span> In the Soffid console, please go to:

`Main Menu > Administration > Configure Soffid > Global Settings > Plugins`

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">3.</span> Then, click the add button (+) and pick the file and Soffild will upload the addon file.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">4.</span> Finally, when the addon is installed, it will be required to restart the Soffid Sync server.

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">5.</span> Once the Sync server is restarted, you could check the plugin was uploaded properly on the plugins page:

`Main Menu > Administration > Configure Soffid > Global Settings > Plugins`

<span style="color: #a6d100; font-weight: bold; font-size: 18px;">6.</span> Now, you can set up the connector.

### Configure Agent

Once the plugin has been uploaded and installed, the next step will be to set up the agent, this is the step where you establish a relation between Soffid and your managed system.

`Main Menu > Administration > Configure Soffid > Integration engine > Agents`

<p class="callout info">More information about how to configure agents can be found on the [Agents](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/agents "Agents") page.</p>

### Connector List

Here you will find all the information needed about the available Soffid connectors to integrate external managed systems. If you miss something important, don't mind making suggestions using **<contact@soffid.com>**.

1. [AWS Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/aws-connector "AWS Connector")
2. [CSV Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/csv-connector "CSV Connector")
    - [Customizable CSV file (CSV Connector type)](https://bookstack.soffid.com/books/connectors/page/customizable-csv-file-csv-connector-type "Customizable CSV file (CSV Connector type)")
3. [Google Apps Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/google-apps-connector "Google Apps Connector")
4. [JSON REST Web Services Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/json-rest-web-services-connector "JSON REST Web Services Connector")
5. [LDAP Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/ldap-connector "LDAP Connector")
6. [Oracle Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/oracle-connector "Oracle Connector")
7. [Oracle EBS Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/oracle-ebs-connector "Oracle EBS Connector")
8. [SAP Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/sap-connector "SAP Connector")
9. [SCIM Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/scim-connector "SCIM Connector")
10. [Shell Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/shell-connector "Shell Connector")
    - [Invoker interface](https://bookstack.soffid.com/books/connectors/page/invoker-interface "Invoker interface")
11. [SQL Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/sql-connector "SQL Connector")
12. [Windows Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/windows-connector "Windows Connector")
    - [HOWTO SSL access to Active Directory](https://bookstack.soffid.com/books/connectors/page/invoker-interface "Invoker interface")
    - [Invoker interface for Active Directory](https://bookstack.soffid.com/books/connectors/page/invoker-interface-for-active-directory-skip-to-end-of-metadata "Invoker interface for Active Directory Skip to end of metadata")
13. [Zarafa Connector](https://bookstack.soffid.com/books/soffid-3-reference-guide/page/zarafa-connector "Zarafa Connector")
14. [SQL Server Connector](https://bookstack.soffid.com/books/connectors/page/sql-server-connector)

###