[](https://discord.gg/GUAy9wErNu)
[](https://discord.gg/GUAy9wErNu)
[](https://github.com/CybercentreCanada/assemblyline)
[](https://github.com/CybercentreCanada/assemblyline-ui)
[](https://github.com/CybercentreCanada/assemblyline/issues?q=is:issue+is:open+label:ui)
[](./LICENCE.md)
# Assemblyline 4 - API and Socket IO server
This component provides the User Interface as well as the different APIs and socketio endpoints for the Assemblyline 4 framework.
## Image variants and tags
| **Tag Type** | **Description** | **Example Tag** |
| :----------: | :----------------------------------------------------------------------------------------------- | :------------------------: |
| latest | The most recent build (can be unstable). | `latest` |
| build_type | The type of build used. `dev` is the latest unstable build. `stable` is the latest stable build. | `stable` or `dev` |
| series | Complete build details, including version and build type: `version.buildType`. | `4.5.stable`, `4.5.1.dev3` |
## Components
### APIs
Assemblyline 4 provides a large set of API that can provide you with all the same information you will find in it's UI and even more. The list of APIs and their functionality is described in the help section of the UI.
All APIs in Assemblyline output their result in the same manner for consistency:
```json
{
"api_response": {}, //Actual response from the API
"api_error_message": "", //Error message if it is an error response
"api_server_version": "4.0.0", //Assemblyline version and version of the different component
"api_status_code": 200 //Status code of the response
}
```
**NOTE**: All response codes return this output layout
#### Running this component
```bash
docker run --name ui cccs/assemblyline-service-ui
```
### SocketIO endpoints
Assemblyline 4 also provide a list of SocketIO endpoints to get information about the system live. The endpoints will provide authenticated access to many Redis broadcast queues. It is a way for the system to notify user of changes and health of the system without having them to query for that information.
The following queues can be listen on:
- Alerts created
- Submissions ingested
- Health of the system
- State of a given running submission
#### Running this component
```bash
docker run --name socketio cccs/assemblyline-service-socketio
```
## Documentation
For more information about this Assemblyline component, follow this [overview](https://cybercentrecanada.github.io/assemblyline4_docs/overview/architecture/) of the system's architecture.
---
# Assemblyline 4 - API et serveur Socket IO
Ce composant fournit l'interface utilisateur ainsi que les différentes API et les points de terminaison Socket IO pour le framework Assemblyline 4.
## Variantes et étiquettes d'image
| **Type d'étiquette** | **Description** | **Exemple d'étiquette** |
| :------------------: | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------: |
| dernière | La version la plus récente (peut être instable). | `latest` |
| build_type | Le type de compilation utilisé. `dev` est la dernière version instable. `stable` est la dernière version stable. `stable` ou `dev` | `stable` ou `dev` |
| séries | Le détail de compilation utilisé, incluant la version et le type de compilation : `version.buildType`. | `4.5.stable`, `4.5.1.dev3` |
## Composants
### APIs
Assemblyline 4 fournit un grand nombre d'API qui peuvent vous fournir toutes les informations que vous trouverez dans l'interface utilisateur et même plus. La liste des API et de leurs fonctionnalités est décrite dans la section d'aide de l'interface utilisateur.
Pour des raisons de cohérence, toutes les API d'Assemblyline produisent leurs résultats de la même manière :
```json
{
"api_response": {}, //Réponse réelle de l'API
"api_error_message": "", //Message d'erreur s'il s'agit d'une réponse d'erreur
"api_server_version": "4.0.0", //Assemblyline version et version des différents composants
"api_status_code": 200 //Code d'état de la réponse
}
```
**NOTE** : Tous les codes de réponse renvoient cette présentation de sortie
#### Exécuter ce composant
```bash
docker run --name ui cccs/assemblyline-service-ui
```
### Points d'extrémité SocketIO
Assemblyline 4 fournit également une liste de points de contact SocketIO pour obtenir des informations sur le système en direct. Ces points de contact fournissent un accès authentifié à de nombreuses files d'attente de diffusion Redis. C'est un moyen utilisé par le système pour informer les utilisateurs des changements et de l'état du système sans qu'ils aient à faire des requêtes d'informations.
Les files d'attente suivantes peuvent être écoutées :
- Alertes créées
- Soumissions reçues
- Santé du système
- État d'une soumission en cours
#### Exécuter ce composant
```bash
docker run --name socketio cccs/assemblyline-service-socketio
```
## Documentation
Pour plus d'informations sur ce composant Assemblyline, suivez ce [overview](https://cybercentrecanada.github.io/assemblyline4_docs/overview/architecture/) de l'architecture du système.
Raw data
{
"_id": null,
"home_page": "https://github.com/CybercentreCanada/assemblyline-ui/",
"name": "assemblyline-ui",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "assemblyline automated malware analysis gc canada cse-cst cse cst cyber cccs",
"author": "CCCS Assemblyline development team",
"author_email": "assemblyline@cyber.gc.ca",
"download_url": null,
"platform": null,
"description": "[](https://discord.gg/GUAy9wErNu)\n[](https://discord.gg/GUAy9wErNu)\n[](https://github.com/CybercentreCanada/assemblyline)\n[](https://github.com/CybercentreCanada/assemblyline-ui)\n[](https://github.com/CybercentreCanada/assemblyline/issues?q=is:issue+is:open+label:ui)\n[](./LICENCE.md)\n\n# Assemblyline 4 - API and Socket IO server\n\nThis component provides the User Interface as well as the different APIs and socketio endpoints for the Assemblyline 4 framework.\n\n## Image variants and tags\n\n| **Tag Type** | **Description** | **Example Tag** |\n| :----------: | :----------------------------------------------------------------------------------------------- | :------------------------: |\n| latest | The most recent build (can be unstable). | `latest` |\n| build_type | The type of build used. `dev` is the latest unstable build. `stable` is the latest stable build. | `stable` or `dev` |\n| series | Complete build details, including version and build type: `version.buildType`. | `4.5.stable`, `4.5.1.dev3` |\n\n## Components\n\n### APIs\n\nAssemblyline 4 provides a large set of API that can provide you with all the same information you will find in it's UI and even more. The list of APIs and their functionality is described in the help section of the UI.\n\nAll APIs in Assemblyline output their result in the same manner for consistency:\n\n```json\n{\n \"api_response\": {}, //Actual response from the API\n \"api_error_message\": \"\", //Error message if it is an error response\n \"api_server_version\": \"4.0.0\", //Assemblyline version and version of the different component\n \"api_status_code\": 200 //Status code of the response\n}\n```\n\n**NOTE**: All response codes return this output layout\n\n#### Running this component\n\n```bash\ndocker run --name ui cccs/assemblyline-service-ui\n```\n\n### SocketIO endpoints\n\nAssemblyline 4 also provide a list of SocketIO endpoints to get information about the system live. The endpoints will provide authenticated access to many Redis broadcast queues. It is a way for the system to notify user of changes and health of the system without having them to query for that information.\n\nThe following queues can be listen on:\n\n- Alerts created\n- Submissions ingested\n- Health of the system\n- State of a given running submission\n\n#### Running this component\n\n```bash\ndocker run --name socketio cccs/assemblyline-service-socketio\n```\n\n## Documentation\n\nFor more information about this Assemblyline component, follow this [overview](https://cybercentrecanada.github.io/assemblyline4_docs/overview/architecture/) of the system's architecture.\n\n---\n\n# Assemblyline 4 - API et serveur Socket IO\n\nCe composant fournit l'interface utilisateur ainsi que les diff\u00e9rentes API et les points de terminaison Socket IO pour le framework Assemblyline 4.\n\n## Variantes et \u00e9tiquettes d'image\n\n| **Type d'\u00e9tiquette** | **Description** | **Exemple d'\u00e9tiquette** |\n| :------------------: | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------: |\n| derni\u00e8re | La version la plus r\u00e9cente (peut \u00eatre instable). | `latest` |\n| build_type | Le type de compilation utilis\u00e9. `dev` est la derni\u00e8re version instable. `stable` est la derni\u00e8re version stable. `stable` ou `dev` | `stable` ou `dev` |\n| s\u00e9ries | Le d\u00e9tail de compilation utilis\u00e9, incluant la version et le type de compilation : `version.buildType`. | `4.5.stable`, `4.5.1.dev3` |\n\n## Composants\n\n### APIs\n\nAssemblyline 4 fournit un grand nombre d'API qui peuvent vous fournir toutes les informations que vous trouverez dans l'interface utilisateur et m\u00eame plus. La liste des API et de leurs fonctionnalit\u00e9s est d\u00e9crite dans la section d'aide de l'interface utilisateur.\n\nPour des raisons de coh\u00e9rence, toutes les API d'Assemblyline produisent leurs r\u00e9sultats de la m\u00eame mani\u00e8re :\n\n```json\n{\n \"api_response\": {}, //R\u00e9ponse r\u00e9elle de l'API\n \"api_error_message\": \"\", //Message d'erreur s'il s'agit d'une r\u00e9ponse d'erreur\n \"api_server_version\": \"4.0.0\", //Assemblyline version et version des diff\u00e9rents composants\n \"api_status_code\": 200 //Code d'\u00e9tat de la r\u00e9ponse\n}\n```\n\n**NOTE** : Tous les codes de r\u00e9ponse renvoient cette pr\u00e9sentation de sortie\n\n#### Ex\u00e9cuter ce composant\n\n```bash\ndocker run --name ui cccs/assemblyline-service-ui\n```\n\n### Points d'extr\u00e9mit\u00e9 SocketIO\n\nAssemblyline 4 fournit \u00e9galement une liste de points de contact SocketIO pour obtenir des informations sur le syst\u00e8me en direct. Ces points de contact fournissent un acc\u00e8s authentifi\u00e9 \u00e0 de nombreuses files d'attente de diffusion Redis. C'est un moyen utilis\u00e9 par le syst\u00e8me pour informer les utilisateurs des changements et de l'\u00e9tat du syst\u00e8me sans qu'ils aient \u00e0 faire des requ\u00eates d'informations.\n\nLes files d'attente suivantes peuvent \u00eatre \u00e9cout\u00e9es :\n\n- Alertes cr\u00e9\u00e9es\n- Soumissions re\u00e7ues\n- Sant\u00e9 du syst\u00e8me\n- \u00c9tat d'une soumission en cours\n\n#### Ex\u00e9cuter ce composant\n\n```bash\ndocker run --name socketio cccs/assemblyline-service-socketio\n```\n\n## Documentation\n\nPour plus d'informations sur ce composant Assemblyline, suivez ce [overview](https://cybercentrecanada.github.io/assemblyline4_docs/overview/architecture/) de l'architecture du syst\u00e8me.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Assemblyline 4 - API and Socket IO server",
"version": "4.5.0.69",
"project_urls": {
"Homepage": "https://github.com/CybercentreCanada/assemblyline-ui/"
},
"split_keywords": [
"assemblyline",
"automated",
"malware",
"analysis",
"gc",
"canada",
"cse-cst",
"cse",
"cst",
"cyber",
"cccs"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9ee5ecaf6e2d5f92f9b9d65f82a2c6b18cb93fa37020a3ad958d2c8bccfd5a5d",
"md5": "1205873c3bd5bc511626bb33061c8949",
"sha256": "c954c2c04edd79326a4afe63aa3ab41210587a224b3c606000bea6ea3c8625ff"
},
"downloads": -1,
"filename": "assemblyline_ui-4.5.0.69-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1205873c3bd5bc511626bb33061c8949",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 190808,
"upload_time": "2025-01-21T17:56:06",
"upload_time_iso_8601": "2025-01-21T17:56:06.141425Z",
"url": "https://files.pythonhosted.org/packages/9e/e5/ecaf6e2d5f92f9b9d65f82a2c6b18cb93fa37020a3ad958d2c8bccfd5a5d/assemblyline_ui-4.5.0.69-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 17:56:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "CybercentreCanada",
"github_project": "assemblyline-ui",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "assemblyline-ui"
}
JSON
