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. Entities 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. Entities 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 dictionary with the tag and the url of the reputation source. URL of the reputation source is not yet implemented.
- occurrences: dates of occurrences 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 licence. 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.8-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91e2c1cb6dd7a4f13754ff7d4d5c3f2bd3422c1cada7ea38525f46fa66e6014d |
|
MD5 | 9e04dd6ebc78f0fe90f4905a7133d805 |
|
BLAKE2b-256 | 2e3872b7cddfb8849b7fcb60da245c4b0af72ea9d5c002c70b265042e9f894eb |