Python wrapper for https://www.cyrating.com.
Project description
python-cyrating
A python wrapper for Cyrating https://www.cyrating.com.
Installation
pip install cyrating
Then in your application root directory use the following command to set up your configuration including your Cyrating token which is provided in your user interface:
echo -e "[cyrating]\ntoken: cyratingtoken" > cyrating.ini
Usage example
>>> import cyrating
>>> cr = cyrating.init()
Method | Description |
---|---|
get_main_company | returns main company |
get_entities | returns list of entities |
get_suppliers | returns list of suppliers |
domains | return list of domains for a company |
set_tags | set tags to a specified domain |
get_assets | get assets for a company |
get_events | get list of active reputation events |
get_certificate | returns certificate of a specific company |
Examples
Returns main company
>>> cr.main_company()
[...]
Returns list of entities
>>> cr.entities()
[...]
Returns list of suppliers
>>> cr.suppliers()
[...]
Returns domains of a company
>>> cr.domains(main_company)
[...]
Tag a domain
>>> cr.set_tags('example.com', ['tag1', 'tag2'])
[...]
Get assets
The method get_assets returns a dictionary of assets with tags and type attributes. Each key of this dictionary represents an asset and is linked to the following attributes:
- type: type of the asset, may be 'domain', 'host' or 'ip]
- tags: list of tags associated to the asset
- domains: list of domains associated to the asset
- entities: list of entities associated to the asset. Entites are the ones included in the subscription.
>>> cr.get_assets(cr.domains(main_company))
[...]
Get the list of active reputation events
The method get_events returns a list of active reputation events. assets parameter is optional and is needed to provide tags association.
An active reputation event includes the following attributes:
- name: name of the asset concerned
- domains: list of domains associated to the asset
- entities: list of entities associated to the asset. Entites are the ones included in the subscription.
- tags: list of tags associated to the asset
- type: type of the asset, may be 'domain', 'host' or 'ip]
- source: a dictionnary with the tag and the url of the reputation source. URL of the reputation source is not yet implemeted.
- occurences: dates of occurences of the event
>>> main_company = cr.main_company()
>>> cr.get_events(main_company, assets=cr.get_assets(main_company))
[...]
Returns certificate of a specific company
>>> main_company = cr.get_main_company()
>>> cr.get_certificate(main_company)
Save certificate of a specific company to a file
>>> main_company = cr.get_main_company()
>>> cr.get_certificate(main_company, filename='Cyrating - Certificate of {}.pdf'.format(main_company['name']))
Meta
Cyrating – @cyrating – hello@cyrating.com
Distributed under the ISCL license. See LICENSE
for more information.
Contributing
- Send issues to issues@cyrating.com
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cyrating-0.0.7-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fd83a9aba8ec9453f60e180b90ae40aefe45ac51f32d882faf0c2fdab0958d48 |
|
MD5 | aaec98cc357757dbf62f46caddefcf23 |
|
BLAKE2b-256 | b6bff108a1e87de020fb0d2c33e8994fde70ffac3458ec051cc197c6c5e0be4a |