# Client

{% hint style="success" %}
Clients have local plug-in capabilities, and the storage and operation of plug-in codes are all completed in the local environment.
{% endhint %}

## Download

<https://www.secasst.com/> Download and install on the official website homepage, currently only supports Mac.

## Usage

### Environment initialization

#### 1、Token configuration

Go to Personal Center to view the Token and fill it into the system configuration of the client.

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/WTxm08xvx3zWftvtKC6r/image.png" alt=""><figcaption></figcaption></figure>

#### 2、Install dependent environment

Since the plug-in runs locally, you need to make sure that your device has Python3 and Docker environment

{% tabs %}
{% tab title="Python3" %}
Version：`3.7-3.11`

Download：<https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg>

brew Install：`brew install python@3.10.11`
{% endtab %}

{% tab title="Docker" %}
Most of the official plugins need to use Docker environment. If you only need to run your own plugins without including official plugins, you don't need to install it. Version range: untested, it is recommended to download the latest version

Download：<https://www.docker.com/products/docker-desktop/>

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/DmXzXsQ4Nh3MmupkwDG3/image.png" alt=""><figcaption></figcaption></figure>

After installation, make sure Docker is running
{% endtab %}
{% endtabs %}

#### 3、Pull the basic tool image

After installing Docker, you also need to pull the basic toolset image, execute the following command

```sh
docker search 'secasst/' --format '{{.Name}}'|xargs -L1 docker pull
```

#### 4、Synchronize official plug-ins

If you want to use local plug-in capabilities, you can go to the Local plug-in interface, click the Synchronize plug-in set button to pull the plug-in from the cloud to the local.

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/fqvcLCYAlYgEshVRPpzT/image.png" alt=""><figcaption></figcaption></figure>

### Usage scenarios

#### 1、Detect targets in the LAN

For example, scanning the IP of the LAN, only the client can achieve this

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/snhGAvwX3wrHdIW4cwmd/image.png" alt=""><figcaption></figcaption></figure>

#### 2、Connect to internal applications

Connect to related internal applications, such as IT systems/security systems/log systems

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/aj6QqfFbucoreDjrjGM6/%E6%88%AA%E5%B1%8F2023-10-26%2022.54.54.png" alt=""><figcaption></figcaption></figure>

### Plug-in development

Taking the masscan plug-in as an example, the plug-in consists of the plug-in name, plug-in description, and plug-in code. The plug-in name and description can be defined according to the actual situation.

<figure><img src="https://content.gitbook.com/content/SGISs7yoIw2jzFn4DdlA/blobs/96N517AJz5aTjaOwRKlI/image.png" alt=""><figcaption></figcaption></figure>

More details about plug-in development can be found in [custom-plugins](https://en.help.secasst.com/expand-customize/custom-plugins "mention")