mopdf.com

IBM Integration Bus V10 WorkshopNov 20166.Click Install, accepting the default to use the Client UI.7.Installation will take a few minutes, during which time you will see a command window openup temporarily. When it has completed, click Close.8.When installation has been completed, create your ACL file in the installation folder of theSecure Gateway client. This will be as follows if you have accepted the default location:C:\Program Files (x86)\Secure GatewayClient\ibm\securegateway\clientIt should contain this single line to allow inbound connections to port 7800:acl allow :7800Page 14 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20163.3 Start IBM Secure Gateway client1.Now start the client by double-clicking on file secgw.cmd in the sub-folder shown.2.At the command line prompt, enter ‘y’:3.The client should start successfully and display output like this, if you scroll down towards theend of the screen.Important – this session needs to be kept running for the duration of this lab, otherwiseBluemix will not be able to reach the REST API. It can be ended later using Ctrl-C.Page 15 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20164.A browser windows should also open like this to show the client is connected.5.Go back to the Secure Gateway on Bluemix, refresh the screen and you should now see thestatus indicator is green to indicate an active client:6.Click on this to display the destination and then click on the cog symbol.7.In the resulting display, you will see the cloud host and port that will be substituted for thehost and port of the IIB host in the REST API UTL. You will need these details later on whenyou are logged on as a different user. Copy these into a file e.g. in C:\user\temp. (In theVM environment, the COPY button may not copy the text to the clipboard and you may haveto use Ctrl-C instead).Page 16 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20164. Register for API Connect on BluemixFor this section, you can remain logged in to Windows as the user "iibadmin.1.Now select the Catalog option once more:2.Scroll to the bottom of the page and then select API Connect under Services, APIs:At the prompt, click CREATE to create the service.3.This may take a minute or so to set up and to log you on to API Connect.You should now see the following information about Draft APIs.Click Got it! when you have finished reading it.Page 17 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop4.Nov 2016You should now see the Draft API view in API Connect. Bookmark this or leave the tabopen.Page 18 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20165. Prepare IIB environment5.1 Configure TESTNODE iibuser for REST applicationsThe IIB support for the REST API requires some special configuration for the IIB node andserver. Cross-Origin Resource Scripting (CORS) must be enabled for the IIB node to executeREST applications. This is also required when testing with the SwaggerUI test tool. Seehttp://www.w3.org/TR/cors/?cm mc uid 09173639950214518562833&cm mc sid 50200000 1452177651 for further information.In Windows, switch user and log in as "iibuser", password "passw0rd".1.Ensure that TESTNODE iibuser is started.2.Check that CORS has been enabled on the IIB node by running the following command in anIntegration Console:mqsireportproperties TESTNODE iibuser-e default-o HTTPConnector-r3.If CORS is enabled, you will see the following lines (amongst others):corsEnabled 'true'corsAllowOrigins '*'corsAllowCredentials 'false'corsExposeHeaders 'Content-Type'corsMaxAge '-1'corsAllowMethods eaders pe'4.If CORS has not been enabled, run the following commands:mqsichangeproperties TESTNODE iibuser-e default-o HTTPConnector-n corsEnabled -v truemqsistop TESTNODE iibusermqsistart TESTNODE iibuserPage 19 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20165.2 Open IIB Log MonitorA useful tool for IIB development on Windows is the IIB Log Monitor. This tool continuouslymonitors the Windows Event Log, and all messages from the IIB and WMB log are displayedimmediately.From the Start menu, click IIB Event Log Monitor. The Monitor will open; it is useful to have thisalways open in the background.This tool is not shipped as part of the IIB product; please contact us directly if you would like acopy.5.3 Configure TESTNODE iibuser to work with DB2If you have already done Lab 1 in this series, you can skip this section.To run this lab, the Integration Bus node must be enabled to allow a JDBC connection to theHRDB database and create the necessary security credentials for TESTNODE iibuser toconnect to the database.1. Open an IIB Command Console (from the Start menu), and navigate toc:\student10\Create HR database2. Run this command and accept the defaults:3 Create JDBC for HRDB3. Run this command and accept the defaults:4 Create HRDB SecurityID4. Stop and restart the node to enable the above definitions to be activatedmqsistop TESTNODE iibusermqsistart TESTNODE iibuserPage 20 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20166. Prepare IIB REST Application6.1 Import and deploy pre-requisite IIB projects1.Start the IIB toolkit from the Start menu and to ensure there are no conflicts with othercomponents, switch to a new workspace, e.g.c:\users\iibuser\IBM\IIB 10\workspace APIC2.In the IIB Toolkit, import the Project Interchange file:C:\student10\REST API HR Service\solution\HR Service getEmployee.10.0.0.6.zipImport all 3 projects in the PI file.3.Delete all deployed resources in the default server and then deploy first HRDB and thenHR Service to server default on TESTNODE iibuser.4.To test the REST API, use the following URL. A shortcut for this is provided in the REST folder inFirefox.http://localhost:7800/HR Services/resources/employees/000010If the REST API is working correctly, the details for employee 000010 should be returned:Page 21 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop5.Nov 2016Now change the URL, substituting the cloud host and port that you saved in section 3.3, forlocalhost:7800, so that the REST API can be accessed from outside the network. The formatwill be, e.g.http:// cloud host : cloud port /HR Services/resources/employees/000010Paste the resulting URL into a browser and confirm that it returns the same details as before. Thisshows that the Secure Gateway connection is working and that API Connect on Bluemix will beable to reach this REST API.6.2 Push REST API definition to IBM API Connect – Web UITo push the REST API from definition using the Web User Interface, follow this section.Alternatively, to push the definition from the Integration Console, skip this section and follow the nextone instead.1.From the Integration Toolkit, start the WebUI for node TESTNODE iibuser:2.Expand Servers under node TESTNODE iibuser by clicking the twisty at the left and thenclick the down arrow to the right of the default server and select the option Push REST APIsto IBM API Connect.Page 22 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop3.Nov 2016The Push to API Management wizard will appear. Provide the following details: Host. Enter one of the following, depending on the Bluemix region you are currentlylogged into:o eu.apiconnect.ibmcloud.com (United Kingdom)o us.apiconnect.ibmcloud.com (US South)o au.apiconnect.ibmcloud.com (Sydney)Port:leave this as 443.User ID: your IBM IDPassword: your IBM passwordand then click Connect to IBM API Connect.You should see a successful connection message as shown here.Now click Next.Page 23 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop4.Nov 2016In API Connect, a product is a set of APIs and Plans in one offering that you make availableto your developers.At the next screen, you are prompted to add a new product that will contain the REST API.Give a title for the product.The name and version will be generated for you.Do not stage the product.When the details have been entered, click Next.Page 24 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop5.Nov 2016At the next screen, select the REST API, scroll down and then click Next.Page 25 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop6.Nov 2016At the next prompt, enter the cloud host name and port from the Secure Gateway connection(saved in section 3.3) in the appropriate places for the http connection.These details will be used in the configuration of the REST API in API Connect on Bluemix,so that inbound connections are permitted to the IIB host system.Click Push to IBM API Connect.7.The push should be successful and a message displayed like the one shown below. Closethe window when you are ready and skip the next section.6.3 Push REST API definition to IBM API Connect – CLIDo not perform this section if you have pushed the REST API definition using the Web UI.To push the REST API definition using the Integration Console, follow this section.We will use the mqsipushapis command, which has the following syntax:Page 26 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 2016mqsipushapis integration node -e integration server -t API Connect host -g API Connect port -u API Connect user ID -a API Connect password -o API Connect organization -r product name -k API Name -x API host : API port Note: the product name specified with the –r flag is a name assigned by the user to the newproduct in API Connect that will contain the API.API Connect host: you will use one of the following, depending on the Bluemix region youare currently logged into:o eu.apiconnect.ibmcloud.com (United Kingdom)o us.apiconnect.ibmcloud.com (US South)o au.apiconnect.ibmcloud.com (Sydney)the API Connect organization is constructed in our case as follows: Bluemix Organization ( Bluemix Space ) . See section 3.1, if you don’t have thisinformation. Note the space between the two parts and that Bluemix Space needs to beplaced in brackets, e.g, for a user with Bluemix Organization iibtester99 workshop andBluemix Space dev, this would be: iibtester99 workshop (dev).Page 27 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop1.Nov 2016To help you, we have provided a script, deploy to APIConnect.cmd, inC:\student10\IIB APIC\commands.In an Integration Console, change to this directory and run the command, entering appropriatevalues in the prompt. For a fictitious user, IBM ID [email protected], in BluemixOrganization iibtester99 workshop and Bluemix Space dev, the output could look like this.This results in the following command being run:mqsipushapis TESTNODE iibuser-e default-t eu.apiconnect.ibmcloud.com-g 443-u [email protected] passw0rd-o "iibtester99 workshop (dev-uk)"-r Employee-k HR Service-x k that the command runs successfully. If it does not, make corrections and try again. Theresponse should look something like this:Page 28 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20167. View REST API in IBM API ConnectFor this section, you can remain logged in to Windows as the user "iibuser” or switchback to user “iibadmin” and continue with your running Bluemix session.1.If you are still logged into API Connect from before, then jump to step 6.Go to ectLog on with your IBM ID and password.You are now logged on to IBM API Connect as an API manager.2.Click on the menu symbol (3.)Then DraftsPage 29 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 Workshop4.Nov 2016You should now see the following screen with information on API Connect Products.Click Got it! when you have finished reading it.5.At the next screen, click APIs.6.If you were already logged on to API Connect from before, refresh the screen.The Employee Service API should be displayed. This is the API that you pushed into IBM APIConnect.Click on HR Department and Employee Services to show the details of the API.Page 30 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20167.Before you get to the API Editor, you will see the following pop-up. Again, click Got it! afterreading.8.Explore the design of the API by navigating the left panel, or scrolling down the page at the right.9.Navigate to the Schemes section under the Design tab and note the https tick box alone isselected, as shown below. This ensures the published URL will be secured using https.Page 31 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 201610. Access to the REST API may be restricted by use of a Client ID and Client Secret which can bedefined in the Security Definitions section and referenced in the Security section below it.Scroll past these, as we shall not be using security definitions in this lab.11. Click the Assemble tab.12. You will see that an assembly flow has been created with a proxy node. Click on this node.Page 32 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 201613. IBM API Connect must be proxy the requests for the REST API into IBM Integration Bus. Thedetails of the cloud host and port were given when the REST API was pushed from IIB and will beof the form:http:// cloud host : cloud port (request.path)To see the full URL, click the maximize symbol as shown.When you have finished, close the window.Page 33 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20168. Test REST API8.1 Set up and run the test1.Click the arrow button to start the test.2.In the navigation pane at the left, click Republish product.3.Now choose an operation to invoke by clicking the down arrow at the right.Page 34 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20164.Scroll down and choose the get /employees/{employeeNumber} operation.5.Now, under the Parameters section, enter an employee number to retrieve, e.g.: 000010 and clickInvoke.6.If successful, data will be returned in the body of the response:Page 35 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopPage 36 of 38Nov 2016Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20168.2 Determine URL of published REST API1.Navigate to the Sandbox catalog by clicking on the menu icon ()and then selecting Dashboard.2.If this is the first time you have navigated here, you will the following screen with information aboutthe Dashboard.Scroll down, if necessary to Click Got it! when you have finished reading it.Page 37 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

IBM Integration Bus V10 WorkshopNov 20163.Click on the Sandbox icon and then Settings.4.Select the Endpoints option from the menu at the left and note the API Endpoint Base URL.5.The published URL will be of the form. API Endpoint Base URL /HR ruct a URL in this form, using your API Endpoint Base URL and a test employee number.An example URL with a test employee number of 000020 r99workshop-dev/sb/HR Services/resources/employees/000020Enter this URL in a browser and you should see a response showing the relevant employee’sdetails:You have now accessed the published REST API successfully as an API user.END OF LAB GUIDEPage 38 of 38Integration with IBM API Connect on BluemixProvided by IBM BetaWorksVersion 10.0.0.6

Page 3 of 38 Integration with IBM API Connect on Bluemix Version 10.0.0.6 Provided by IBM BetaWorks 1. Introduction This lab guide will show you how to publish a REST API that is deployed on IBM Integration Bus (IIB), using IBM API Connect (APIC) on IBM Bluemix, ready to be controlled from anywhere with an internet connection, through IBM .