Versions Compared

Old Version 3

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

Saved on

compared with

New Version 4

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.
    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. Hello world!
    Set your software and make your first request!
  4. Running your testsRunning test scripts. 
    Test the S7 Agent API to prevent future problems
  5. Signing of the contract of EDS. 
    Sign the contract electronically
  6. Accessing the production area.
    Complete integration and use the capabilities of the S7 Agent API 7 days after completing the application

Target period — 7 working days

Environment

Test

Production

Step 1: Application for connection

. 

  1. Contact to manager for your region and request them for an application

    from 

    from at vm@s7.ru; (question) link to emails?

     vm@s7.ru

  2. Fill the application

    from with

    form with link to your portal and send to S7 manager;

  3. S7 checks your form and initiate registration in our systems, include JIRA for communication with our technical support.

Step 2: Access to the test environment

. 

1. Receive JIRA account credentials from S7;

2

1

. Check your environment for OpenSSL and install additional software

OpenSSL is

(required to create

an

a request for SSL certificate

For Windows

):


Panel
titleFor Windows/Solaris

Download the last binary version of OpenSSL at https://www.openssl.org/community/binaries.html and

setup

install software


Code Block
titleFor
For 
GNU/Linux

code
sudo apt install openssl


Panel
titleFor 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.


    3. Use command line (as administrator) to create private key:

    Panel


    Code Block
    openssl genrsa -out
    Info
    titleCreate private key:
    openssl genrsa -out 
    ${clientkey}.pem 2048

    Image Removed

    You have to replace ${clientkey} into understandable name using your local naming policies.

    Image Added

    4. Create request for SSL certificate:

    Panel


    Code Block
    openssl req -new -key
    Info
    titleCreate request on SSL certificate
    openssl req -new -key 
    ${clientkey}.pem -out ${clientcsr}.pem
    Image Removed
    Select their name for

    Replace ${clientcsr} into used name on previous step;

    You have to replace ${clientkey}

    ,

    and ${clientcsr} into understandable name using your local naming policies.

    Enter information about

    Image Added

    5. Fill details of request for SSL certificate:

    Panel

    Mandatory:

    • 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

    6. Create a new task with request of SSL certificate (request_csr) by JIRA

    Panel
    • (warning) Danil Trefilov добавит пример задачи как она должна выглядеть
    • Attach to task created private key (test_key)
     
    • and request
    on
    • for SSL certificate (request_csr).
    (warning)

    • Check “Bin” (OpenSSL) folder for those files.

    7. Receive credentials for test environment from our technical support:

  • Send  to JIRA request on SSL certificate (request_csr)

    • Receive the certificate, personal login and password for basic authentication and
    Panel
    • a SSL certificate (*.crt file)
    • personal credentials for basic authentication (login and password)
    • test access parameters for requests

    start the import.

    • (XML block Party)

    8. Import SSL certificate and create key store file:

    Panel


    Code Block
    openssl pkcs12 -export -in
    Info
    titleImport SSL certificate
    openssl pkcs12 -export -in 
    ${clientcert}.pem -inkey ${clientkey}.pem -out ${client}.p12 -name "${name}"
    Image Removed
    (warning) Export

    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

    password for key sore file which will be requested while importing into test software

    Image Added

    Step 3: Hello world! 

    1. If you using test software build in browser you have to import keys (or check your software's documentation):

    Panel
    • Mozilla Firefox: Menu → Preferences → Advanced → ViewCertificates → Your Certificates → Import → Choose created key store file (*.p12) on previous step;
    • Google Chrome: Settings → Advanced Settings → HTTPS/SSL → Import → Choose created key store file (*.p12) on previous step.

    2. For a better experience, we prefer to use SoapUI for testing:

    Panel

    Download the last binary version of SoapUI at https://www.soapui.org/downloads/soapui.html and install software

    3. Open SoapUI and create a new SOAP project: SoapUI → File → Preferences → New SOAP project 



    1. Open SoapUI and create a new project: SOAP

    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)

    Step 3: Hello world! 

    1. Check current versions available at test environment above
    2. Use personal login and password for basic authentication and test access parameters for requests
    3. Create SOAP project

    Open —  SoapUI > File > Preferences > SSL Setting

    Specify the path to the file jks and choose «requires client authentication».

    3. For better experience we prefer to use SoapUI for test:


    3. For better experience we prefer to use SoapUI for test:


    3. For better experience we prefer to use SoapUI for test:


    3. For better experience we prefer to use SoapUI for test:


    1. Create request
    2. Set BA for request 
    3. Set SSL for request


    1. Set header for version
    2. Send — Hello world!

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


    Step 4: Running your

    test scripts.

    tests

    1. Check current versions available at test environment above
    2. Check API documentation
    3. Basic scenario
    4. We use actual schedule for flights but you may feel free for create bookings and issue tickets (but some minor discrepancies between test and production are still exist) 
    5. No time limits for testing
    6. Give us feedback through your manager or technical support by JIRA

    Step 5: Signing of the contract of EDS

    . 

    1. Ready to production environment? Notify your manager
    2. Катя?
    3. Check basic flow? Review? Prod monitoring?
    4. Create online new validator without transactions history?

    Step 6: Accessing the production area

    . 

    1. create new certificate for production ()
    2. send to JIRA
    3. recieve new BA and SSL and access parameters from support
    4. use headers for actual and tested version
    5. Try to use read operations to check your first bookings and tickets that they are ok
    6. If you do not still sure ask our technical support by by JIRA


    Info

    If you still have any question, try to resolved it with FAQ, documentation or ask our technical support by JIRA or email at api.support@s7.ru