Versions Compared

Old Version 2

changes.mady.by.user Pavel A. Smirnov (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Pavel A. Smirnov (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Steps

  1. Application for connection
.

  1. All information required for connection — in one application
  2. Access to the test environment
. 

  1. Get access to the test environment and integrate under the supervision of S7 technicians
Running test scripts. 
  1. Hello world!
    Set your software and make your first request!
  2. Running your tests
    Test the S7 Agent API to prevent future problems
  3. Signing of the contract of EDS
. 

  1. Sign the contract electronically
  • Accessing the production area.
    Complete integration and use the capabilities of the S7 Agent API 7 days after completing the application

    • Note

    • Target period 7 working days
    • 99.7% accessibility
    • Technical support by JIRA and email at api.support@s7.ru
    • Documentation with examples
    • FAQ

    Environment

    Test

    Production

    Step 1: Application for connection. 

    1. Fill and send an application from (question) Откуда, куда и как?
    2. Request access to JIRA (question) зачем? Нельзя по заявке это делать?
    3. Create a JIRA task for аccess to the test environment (question) зачем? Нельзя по заявке это делать?

    Step 2: Access to the test environment. 

    1. Check your environment for OpenSSL and install additional software

    OpenSSL is required to create an SSL certificate

    • For GNU/Linux
    Code Block
    sudo apt install openssl
    • For MacOS
      No action is required — already included in OS

    2. Check your environment for JDK version 7 or 8 and install additional software

    JDK includes keytool which is required to create an SSL certificate (question) Зачем? Это ведь не требуется для последних версий SoapUI

    Download the last version of JDK at http://www.oracle.com/technetwork/java/javase/downloads/index.html and setup

    2. Create an SSL certificate for the test environment and configure your software

    3. Import certificate and check availability of actual API version.

    Download and setup OpenSSL.
    The last binary version for Windows/Solaris can be downloaded at:
    https://www.openssl.org/community/binaries.html

    For GNU/Linux:

  • Download and setup JDK version 7 or 8.
    To convert the certificate, use the keytool included in the JDK:

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

    • Use command line (administrator) create private key and request on SSL certificate.

    Info
    titleCreate private key:

    openssl genrsa -out ${clientkey}.pem 2048

    Image Removed

    Info
    titleCreate request on SSL certificate

    openssl req -new -key ${clientkey}.pem -out ${clientcsr}.pem

    Image Removed

    Select their name for ${clientkey}, ${clientcsr} .

    Enter information about:

    • Country Name (2 letter code)
    • State or Province Name
    • Locality Name (eg, city)
    • Organization Name (eg, company)
    • Organizational Unit Name (eg, section)
    • Common Name (your name or server's hostname)

    No need to specify:

    • A challenge password
    • An optional company name
    (warning) Check “Bin” (OpenSSL) folder where there will be  the private key (test_key)  and request on SSL certificate (request_csr).(warning)

  • Send  to api.support@s7.ru  request on SSL certificate (request_csr)

    • After receiving the certificate from api.support@s7.ru start the import.

    Info
    titleImport SSL certificate

    openssl pkcs12 -export -in ${clientcert}.pem -inkey ${clientkey}.pem -out ${client}.p12 -name "${name}"

    Image Removed
    (warning) Export Password – key for test.p12 (warning)

    Import to browser:
    Mozilla Firefox > Menu > Preferences > Advanced > ViewCertificates > Your Certificates > Import > Выберите ${client}.p12
    Google Chrome > Settings > Advanced Settings  > HTTPS/SSL > Import > Выберите ${client}.p12

    Conversion SSL certificate with use JDK

    Info
    titleConversion SSL certificate

    keytool  -importkeystore  -srckeystore ${client}.p12  -destkeystore ${client}.jks  -srcstoretype PKCS12  -deststoretype JKS  -deststorepass ${password}  -srcstorepass ${password}

    Image Removed
    Warning
    titleAttention

    deststorepass ${password}  and  srcstorepass ${password} should be identical.

    (warning) After the command we get the file — test.jks (warning)
    Open —  SoapUI > File > Preferences > SSL Setting
    Specify the path to the file jks and choose «requires client authentication».
    Image Removed

    Step 3: Running test scripts. 

    1. Check API documentation

    Step 4: Signing of the contract of EDS. 

    Step 5: Accessing the production area. 

    Steps

    1. Application for connection.
      All information required for connection — in one application
    2. Access to the test environment. 
      Get access to the test environment and integrate under the supervision of S7 technicians
    3. Running test scripts. 
      Test the S7 Agent API to prevent future problems
    4. Signing of the contract of EDS. 
      Sign the contract electronically
    5. Accessing the production area.
      Complete integration and use the capabilities of the S7 Agent API 7 days after completing the application

    Note

    • Target period 7 working days
    • 99.7% accessibility
    • Technical support by JIRA and email at api.support@s7.ru
    • Documentation with examples
    • FAQ

    Environment

    Test

    Production

    1. Access to production environment
      Get access to the production environment and complete integration
    2. Maintenance
      Use the all of capabilities of the S7 Agent API and stay tuned for a new features!

    Choose your role

    RoleDescriptionTarget period
    Integratora developer, who creates a solution for agents and proceed integration with the S7 Agent API7 working days
    Agent with own solutionan agent, who creates own solution for yourself and proceed integration with the S7 Agent API7 working days
    Agent with Integrator's solutionan agent, who going to use solution to connect to S7 environment, provided by integrator 3 working days


    Environment

    Excerpt Include
    Submitting requests | S7 Agent API
    Submitting requests | S7 Agent API
    nopaneltrue

    Step 1: Application for connection. 

    1. Fill and send an application from (question) Откуда, куда и как?
    2. Request access to JIRA (question) зачем? Нельзя по заявке это делать?
    3. Create a JIRA task for аccess to the test environment (question) зачем? Нельзя по заявке это делать?

    Step 2: Access to the test environment. 

    1. Check your environment and prepare

    • For GNU/Linux
    Code Block
    sudo apt install openssl
    • For MacOS

      No action is required

       — already included in OS

    2. Create an SSL certificate for the test environment and configure your software

    3. Import certificate and check availability of actual API version.

    Download and setup OpenSSL.
    The last binary version for Windows/Solaris can be downloaded at:
    https://www.openssl.org/community/binaries.html

    For GNU/Linux:

  • Download and setup JDK version 7 or 8.
    To convert the certificate, use the keytool included in the JDK:

    http://www.oracle.com/technetwork/java/javase/downloads/index.html

    • Use command line (administrator) create private key and request on SSL certificate.

    Info
    titleCreate private key:

    openssl genrsa -out ${clientkey}.pem 2048

    Image Removed

    Info
    titleCreate request on SSL certificate

    openssl req -new -key ${clientkey}.pem -out ${clientcsr}.pem

    Image Removed

    Select their name for ${clientkey}, ${clientcsr} .

    Enter information about:

    • Country Name (2 letter code)
    • State or Province Name
    • Locality Name (eg, city)
    • Organization Name (eg, company)
    • Organizational Unit Name (eg, section)
    • Common Name (your name or server's hostname)

    No need to specify:

    • A challenge password
    • An optional company name
    (warning) Check “Bin” (OpenSSL) folder where there will be  the private key (test_key)  and request on SSL certificate (request_csr).(warning)

  • Send  to api.support@s7.ru  request on SSL certificate (request_csr)

    • After receiving the certificate from api.support@s7.ru start the import.

    Info
    titleImport SSL certificate

    openssl pkcs12 -export -in ${clientcert}.pem -inkey ${clientkey}.pem -out ${client}.p12 -name "${name}"

    Image Removed
    (warning) Export Password – key for test.p12 (warning)

    Import to browser:
    Mozilla Firefox > Menu > Preferences > Advanced > ViewCertificates > Your Certificates > Import > Выберите ${client}.p12
    Google Chrome > Settings > Advanced Settings  > HTTPS/SSL > Import > Выберите ${client}.p12

    Conversion SSL certificate with use JDK

    Info
    titleConversion SSL certificate

    keytool  -importkeystore  -srckeystore ${client}.p12  -destkeystore ${client}.jks  -srcstoretype PKCS12  -deststoretype JKS  -deststorepass ${password}  -srcstorepass ${password}

    Image Removed
    Warning
    titleAttention

    deststorepass ${password}  and  srcstorepass ${password} should be identical.

    (warning) After the command we get the file — test.jks (warning)
    Open —  SoapUI > File > Preferences > SSL Setting
    Specify the path to the file jks and choose «requires client authentication».
    Image Removed

    Step 3: Running test scripts. 

    1. Check API documentation

    Step 4: Signing of the contract of EDS. 

    Step 5: Accessing the production area.