new: [concept] first draft of the CyCAT url

including publisher and project minimal required fields.
main
Alexandre Dulaunoy 2021-02-19 07:04:47 +01:00
parent 66a8b47b79
commit 0ed070631a
No known key found for this signature in database
GPG Key ID: 09E2CD4944E6CBCD
1 changed files with 43 additions and 0 deletions

43
_services/concept.md Normal file
View File

@ -0,0 +1,43 @@
---
title: "CyCAT - Core Concept"
date: 2021-02-19T01:33:46+10:00
featured: true
weight: 1
layout: service
---
# Concept of CyCAT url
A CyCAT url is composed of a publisher short name, a project short name and the associated UUID of the specific item. An item can be any part of the collection produced
by this publisher under a specific project. The CyCAT url is composed of two namespaces separated by colon and a final UUID appended after a colon. The CyCAT url is in UTF-8 format.
`publisher-short-name`:`project-short-name`:`UUID`
## Publisher
A publisher can be any organisation, project or individual requesting a publisher to CyCAT.
| Field name | Description | Required |
| ------------- |:---------------------------| ---------:|
| `name` | Name of the publisher (full name)| :heavy_check_mark: |
| `short-name` | Name of the publisher (short name) | :heavy_check_mark: |
| `description` | Description of the publisher | :heavy_check_mark: |
| `cycat-uuid` | assigned CyCAT UUID | :heavy_check_mark: |
| `link` | Internet link referencing the publisher | :heavy_check_mark: |
Publisher examples: `mitre`, `circl`, `misp`
## Project
A publisher can request one or more project to CyCAT associated to the publisher namespace.
| Field name | Description | Required |
| ------------- |:---------------------------| ---------:|
| `name` | Name of the project (full name)| :heavy_check_mark: |
| `short-name` | Name of the project (short name) | :heavy_check_mark: |
| `description` | Description of the project | :heavy_check_mark: |
| `cycat-uuid` | assigned CyCAT UUID | :heavy_check_mark: |
| `link` | Internet link referencing the project | :heavy_check_mark: |
| `license` | License(s) of the project in SPX identifier (array) | :heavy_check_mark: |
| `type` | [Taxonomy type](https://github.com/CyCat-project/cycat-taxonomy) of the project from CyCAT taxonomy | :heavy_check_mark: |
| `scope` | [Taxonomy scope](https://github.com/CyCat-project/cycat-taxonomy) of the project from CyCAT taxonomy | :heavy_check_mark: |