معرفی شرکت ها
cyrating-1.0.9
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Python wrapper for https://www.cyrating.com
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cyrating-1.0.9 |
| نام | cyrating |
| نسخه کتابخانه | 1.0.9 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Cyrating |
| ایمیل نویسنده | tech@cyrating.com |
| آدرس صفحه اصلی | https://www.cyrating.com |
| آدرس اینترنتی | https://pypi.org/project/cyrating/ |
| مجوز | ISC |
# python-cyrating
A python wrapper for Cyrating https://www.cyrating.com.
[](https://pypi.org/project/cyrating/)
[](https://github.com/wq/python-requirejs/blob/master/LICENSE)
[](https://pypi.org/project/cyrating/)
## Installation
```sh
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:
```sh
echo -e "[cyrating]\ntoken: cyratingtoken" > cyrating.ini
```
## Usage example
```python
>>> import cyrating
>>> cr = cyrating.init()
```
The init method takes into account 2 optional parameters:
- token: the Cyrating token
- proxies: the list of proxies to use when making a request. See [requests docs](https://requests.readthedocs.io/en/master/user/advanced/#proxies) for more information
Additional methods listed below are available
| Method | Description |
| -------------- | ----------------------------------------------------------------------------------------------------- |
| main_company | returns the structure of the main company |
| entities | returns a list of entities |
| suppliers | returns a list of suppliers |
| competitors | returns a list of competitors |
| domains | returns a list of domains for a company |
| assets | returns a list of assets for a given company |
| technologies | returns a list of identified technologies for a given company |
| set_tags | sets tags to a given domain (require admin privileges) |
| facts | returns the results of best practices controls |
| events | returns a list of active reputation events |
| certificate | returns a certificate of a given company |
| members | returns a list of members, including child subscriptions' ones (require admin privileges) |
| rating_history | returns a list of the last 52 ratings numbers for a given company |
| scope | returns a list of the last 52 scopes (domain names) taking into account for rating of a given company |
| scope_updates | returns a list of the last scope updates including added and removed domains |
# Examples
**Get info of the main company**
The method main_company returns a company identified as the main company.
```python
>>> cr.main_company()
[...]
```
**Get the list of entities**
The method entities returns the list of companies identified as entities.
```python
>>> cr.entities()
[...]
```
**Get the list of suppliers**
The method suppliers returns the list of companies identified as suppliers.
```python
>>> cr.suppliers()
[...]
```
**Get the list of competitors**
The method competitors returns the list of companies identified as competitors.
```python
>>> cr.suppliers()
[...]
```
**Tag a domain or an AS Number**
The method set_tags affects a list of tags to a domain name or an AS Number. All assets related with this domain name or with this AS Number will be updated too.
```python
>>> cr.set_tags('example.com', ['tag1', 'tag2'])
[...]
>>> cr.set_tags('ASXXXXX', ['tag3'])
[...]
```
**Get the list of assets**
The method assets returns a list of assets with tags and type attributes. Each key of this dictionary represents an asset and is linked to the following attributes:
- asset: the asset name
- type: type of the asset, may be 'domain', 'host' or 'ip'
- entities: list of entities linked with the asset. Entities are the ones included in the subscription.
- tags: list of tags linked with the asset
- related: list of assets linked with the asset
- domains: list of domains linked with the asset
```python
>>> cr.assets(main_company)
[...]
```
**Get the list of detected technologies**
The method technologies returns a list of detected technologies for a given company. _assets_
parameter is optional and is needed to provide tags association
Each item of the detected technologies includes the following attributes:
- name: name of the detected technology
- category: name of the technology category
- asset: name of the asset supporting the detected technology
- domain: domain name / AS Number linked with the asset
- entities: list of entities linked with the asset. Entities are the ones included in the subscription.
- tags: list of tags linked with the asset
```python
>>> main_company = cr.main_company()
>>> cr.technologies(main_company, assets=cr.assets(main_company))
[...]
```
**Get the results of best practices controls**
The method facts returns the results of best practices controls. _assets_
parameter is optional and is needed to provide tags association. _extra_filter_ is also an optional to filter results server-side.
Each item of the results includes the following attributes:
- domain: domain name / AS Number linked with the asset
- category: name of the best practice's category
- entities: list of entities linked with the asset. Entities are the ones included in the subscription.
- tags: list of tags linked with the asset
- type: type of the asset, may be 'domain', 'host' or 'ip'
- name: name of the resource
- results: raw results of the control
- grade: unitary score of the control
- impact: impact on rating of controls which lead to a downgrade.
```python
>>> main_company = cr.main_company()
>>> cr.facts(main_company, assets=cr.assets(main_company))
[...]
```
**Get the list of active reputation events**
The method 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
- category: name of the reputation's category
- domains: list of domains / AS Numbers linked with the asset
- entities: list of entities linked with the asset. Entities are the ones included in the subscription.
- tags: list of tags linked with 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
- occurrences: dates of occurrences of the event
- score: deprecated, replaced by impact
- impact: impact on rating of the company. Please note that Cyrating algorithm streamlines this score by resource and reputation's category
```python
>>> main_company = cr.main_company()
>>> cr.events(main_company, assets=cr.assets(main_company))
[...]
```
**Returns certificate of a given company**
```python
>>> main_company = cr.main_company()
>>> cr.certificate(main_company)
```
**Save the certificate of a given company to a file**
```python
>>> main_company = cr.main_company()
>>> cr.certificate(main_company, filename='Cyrating - Certificate of {}.pdf'.format(main_company['name']))
```
**Get the list of members**
```python
>>> cr.members()
[...]
```
**Get a list of the last 52 ratings for a given company**
```python
>>> main_company = cr.main_company()
>>> cr.rating_history(main_company)
[...]
```
**Get a list of the last 52 scopes for a given company**
The method scope returns a list of the last 52 scopes for a given _company_. A scope is a list of domain names taking into account for rating of a given company
A scope includes the following attribute:
- domainnames: list of domains names supporting our rating
```python
>>> main_company = cr.main_company()
>>> cr.scope(main_company)
[...]
```
**Get a list of scope updates**
An additional method is available to get scope updates for a given company including added domains and removed domains between several ratings.
A scope includes the following attributes:
- added: domains added to a rating scope
- removed: domains removed from a rating scope
- date: date of rating
```python
>>> main_company = cr.main_company()
>>> scope = cr.scope(main_company)
>>> updates = cr.scope_updates(scope)
[...]
```
## Regression
After version 1.0.15, the method assets returns a list instead of a dictionary
## Meta
Cyrating – [@cyrating](https://twitter.com/cyrating) – hello@cyrating.com
Distributed under the ISCL licence. See `LICENSE` for more information.
## Contributing
1. Send issues to issues@cyrating.com
نیازمندی
| مقدار | نام |
|---|---|
| >=2.25.1,<3.0.0 | requests |
| >=2.1.0,<3.0.0 | PyJWT |
| >=5.0.2,<6.0.0 | configparser |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6,<4.0 | Python |
نحوه نصب
نصب پکیج whl cyrating-1.0.9:
pip install cyrating-1.0.9.whl
نصب پکیج tar.gz cyrating-1.0.9:
pip install cyrating-1.0.9.tar.gz