Skip to main content

The SOLIDserverRest is a library to drive EfficientIP API

Project description

License

pipeline status

SOLIDserverRest

This 'SOLIDserverRest' allows to easily interact with SOLIDserver's REST API. It allows managing all IPAM objects through CRUD operations.

  • Free software: BSD2 License

This 'SOLIDserverRest' is compatible with SOLIDserver version 7 and ownward.

Install

Install 'SOLIDserverRest' using pip in your virtualenv:

	pip install SOLIDserverRest

Usage

Using the SOLIDserverRest advanced object (recommended)

With basic authentication

All commands and object manipulation are going through a SOLIDserver main object, handling the connection to the manager and pushing API calls. The creation of a SOLIDserver object is done like that:

from SOLIDserverRest import *
from SOLIDserverRest import adv as sdsadv

SDS_HOST = "192.168.254.254"
SDS_LOGIN = "foo"
SDS_PWD = "bar"

sds = sdsadv.SDS(ip_address=SDS_HOST,
                 user=SDS_LOGIN,
                 pwd=SDS_PWD)
try:
    sds.connect()
except SDSError as e:
    logging.error(e)
    exit(1)

print(sds)

With token authentication (SDS release >= 8.4.0)

from SOLIDserverRest import *
from SOLIDserverRest import adv as sdsadv

SDS_HOST = "192.168.254.254"
SDS_TOKEN_ID = "8628f88cbd40df99903d6f385caa0462"
SDS_TOKEN_SEC = "ca8ec3c0f07b380c4723349230901d40a84ba4b4987c12863b66b0b5297ad922"

sds = sdsadv.SDS(ip_address=SDS_HOST)
sds.set_token_creds(keyid=SDS_TOKEN_ID,
                    keysecret=SDS_TOKEN_SEC)
try:
    sds.connect(method="token")
except SDSError as e:
    logging.error(e)
    exit(1)

print(sds)

More examples in the example directory.

Using the SOLIDserverRest object (basic mapping)

The raw API is mapped using the SOLIDserverRest object which handle the connection, prepare the formating and handle some errors. It can be usefull twhen the advanced library is not yet implementing an object that you require in your code.

1. Declare endpoint API point

Set the API endpoint you want to talk with through API. Could use an IP address (v4 or v6) or a host name

  • host = IP address of the SOLIDserver server
con = SOLIDserverRest("fqdn_host.org")

2. Specify connection method

You can use native connection mode using SOLIDserver default method which provide authentication through headers in the requests with information encoded in base64

  • user = user who want to use
  • password = password of the user
	con.use_native_sds(user="apiuser", password="apipwd")

You can also use the basic authentication method for connecting the SOLIDserver.

  • user = user who want to use
  • password = password of the user
	con.use_basicauth_sds(user="apiuser", password="apipwd")

3. Set TLS security

SSL certificate chain is validated by default, to disable it, use the set_ssl_verify method

        con.set_ssl_verify(False)  # True by default
	rest_answer = con.query("method", "parameters")

Otherwise, you have to provide the certificate file:

    con = SOLIDserverRest(SERVER)

If the certificate file is not valide, an exception SDSInitError is raised.

4. Request to SOLIDserver API

You need parameters:

  • method = choose your method in the list below
  • parameters = Python dictionary with parameters you want to use
	rest_answer = con.query("method", "parameters")

5. Analyze answer

  • rest_answer => object name
  • rest_answer.status_code => current http answer code set in the object
  • rest_answer.content => Answer core from SOLIDserver API set in the object

Example:

	print(rest_answer)
	print(rest_answer.status_code)
	print(rest_answer.content)

Methods that could be used

Methods are organized to match the ontology used in SOLIDServer, you will find:

  • Sites - address spaces
  • Subnets (v4 and v6)
  • Pools (v4 and v6)
  • Addresses (v4 and v6)
  • Aliases (v4 and v6)
  • DNS servers, views, zones, RR, acl, key
  • application manager
  • DHCP server, scope, shared net, range, static, group, options
  • device manager
  • VLAN manager
  • Network Object Manager

More information about supported methods in the specific document

Tests

Last set of tests run on 19/Feb/2024 using:

  • SOLIDserver release 8.3.2
  • python libs:
    • chardet 5.2.0
    • urllib3 1.26.18
    • idna 3.6
    • requests 2.31.0
    • PySocks 1.7.1
    • pyOpenSSL 24.0.0
    • packaging 23.2

coverage results

---------- coverage: platform win32, python 3.11.3-final-0 -----------
Name                                        Stmts   Miss  Cover
---------------------------------------------------------------
SOLIDserverRest\Exception.py                   25      4    84%
SOLIDserverRest\SOLIDserverRest.py            167     20    88%
SOLIDserverRest\__init__.py                     5      0   100%
SOLIDserverRest\adv\__init__.py                17      0   100%
SOLIDserverRest\adv\base.py                   117     13    89%
SOLIDserverRest\adv\class_params.py            84      4    95%
SOLIDserverRest\adv\device.py                  87     72    17%
SOLIDserverRest\adv\device_tools.py           128    113    12%
SOLIDserverRest\adv\devif.py                  122     99    19%
SOLIDserverRest\adv\dns.py                    150     65    57%
SOLIDserverRest\adv\dns_record.py             404    117    71%
SOLIDserverRest\adv\dns_view.py               105     37    65%
SOLIDserverRest\adv\dns_zone.py               144     19    87%
SOLIDserverRest\adv\ipaddress.py              128      0   100%
SOLIDserverRest\adv\network.py                219      6    97%
SOLIDserverRest\adv\nom_folder.py             119     10    92%
SOLIDserverRest\adv\nom_interface.py          267     46    83%
SOLIDserverRest\adv\nom_network_object.py     123     27    78%
SOLIDserverRest\adv\sds.py                    140     11    92%
SOLIDserverRest\adv\space.py                   56      1    98%
SOLIDserverRest\adv\validators.py              28      6    79%
SOLIDserverRest\mapper.py                      24      0   100%
---------------------------------------------------------------
TOTAL                                        2659    670    75%

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

solidserverrest-2.9.2.tar.gz (49.0 kB view details)

Uploaded Source

Built Distribution

solidserverrest-2.9.2-py3-none-any.whl (58.8 kB view details)

Uploaded Python 3

File details

Details for the file solidserverrest-2.9.2.tar.gz.

File metadata

  • Download URL: solidserverrest-2.9.2.tar.gz
  • Upload date:
  • Size: 49.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.3

File hashes

Hashes for solidserverrest-2.9.2.tar.gz
Algorithm Hash digest
SHA256 1a7c0369b00cb7fede7b983e8879d14de1456497b9bc21796b5fabe1700f97f4
MD5 73249fd51a5292a74a9295d3c91646d3
BLAKE2b-256 98641d5896293cf40112f10f78633b3f25903e3cb7a8f8aba63298b886aad9d4

See more details on using hashes here.

File details

Details for the file solidserverrest-2.9.2-py3-none-any.whl.

File metadata

File hashes

Hashes for solidserverrest-2.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f057d7603c7f178193afd15777e98bbdd199f92c7c7e8983a8a725e423981d99
MD5 1d7b694ca81387d5e0dbcf945b673cf6
BLAKE2b-256 1c176565e46a449124cc3a8ab2c8b27c99c29d21127050ecb1de6fdd469605c2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page