andorsoft, s.a. - api connect · open api –swagger 2.0 •the openapi specification (aka swagger...

64
0 API Connect Arnauld Desprets - [email protected] Technical Sale

Upload: others

Post on 22-Mar-2021

7 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

0

API ConnectArnauld Desprets - [email protected] Sale

Page 2: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

1

Agenda

1. API – Understanding the space

2. API Connect

3. Sample implementations

4. Démonstration

Page 3: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

2

API - Definition

API = standard interface

based on web technologies

• HTTP

• TLS

• REST

• JSON / XML

• OAuth2.0

• Open API

• …

API ~ Product

intr

oduction

gro

wth maturity

declin

e

timesale

s

Page 4: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

3

Open API – Swagger 2.0

• The OpenAPI Specification (aka

Swagger Specification):

specification for machine-

readable interface files for

describing, producing,

consuming, and visualizing

RESTful web services.

• Development of the OpenAPI

Specification (OAS) is overseen

by the Open API Initiative: open

source collaborative project of the

Linux Foundation.

Page 5: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

4

Landscape

• Cloud, mobile analytics, and social are fueling the hypergrowth of

API-centric, business as-a-service economies

Needs in 2013!

Page 6: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

5

Forrester TEI Study Benefit Categories

• Source: Forrester TEI study based on surveys of 32 US-based API Connect Customers, The Total Economic Impact(TM) Of An

API Management Solution, a commissioned study conducted by Forrester Consulting on behalf of IBM, February 2017

Improved Time To Market

Internal Mobile Projects 20%

Internal Social Media Projects 30%

Internal Data & Analytics Projects 30%

Internal Other Projects 20%

External Partner Projects 25%

Public Projects 35%

Page 7: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

6

An API Strategy To…

Securely expose

systems of record

Apps and data to

Mobile, IoT, &

hybrid cloud apps

Publish APIs to

expand brand

reach

Tap into developer

& partner

ecosystems

Enable new

business

Monetize existing

and new data &

algorithms

Speed application

development

Via self service

library of reusable

APIs

Page 8: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

8

Agenda

1. API – Understanding the space

2. API Connect

3. Sample implementations

4. Démonstration

Page 9: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

9

API Connect

Business Partner Apps

Mobile & Web Apps

Enterprise Internal Apps

Internet of Things

z System / Legacy Apps

Cloud Service

Application Server

ESB / Middleware

Data Store

Mic

ros

erv

ice

s

Tra

ffic

API Traffic

API Gateway

(DataPower/ GW)

Microservices

Runtime

(Node.js)

Developer

Portal

API Management

Node

Developer

ToolkitExternal App

Developer

Internal App

Developer

Partner App

Developer

For API owners, developers, business users (API providers)

For app developers (API consumers)

API Policy enforcement

Page 10: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

10

API Connect == Facade to DataPower

• Security

• SOAP Support

• High performance

• SLM

• B2B use cases

Page 11: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

11

API Connect Topology – API Manager

Page 12: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

12

Manager Analytics

• Kibana implementation

• High customization of the

visualisations

• Third party externalisation

• Event (details)

Page 13: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

13

API Connect Portal

• Drupal implemenation

• High customization

• Testing

• Apps management

• Product/Plan subscription

Page 14: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

14

API Connect combines API creation & API definition

API

Definition

API

Creation

API Gateway

API

Run

Page 15: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

15

API Connect combines API creation & API definition

Product

Assembly

Policies

Vendor Extensions

x-ibm-…

ModelsData

Sources

Page 16: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

16

Data sources supported by Loopback applications

• In-memory db

• In-memory key-value connector

• Email

• IBM DB2

• UBM Dash DB

• IBM MQ Light

• IBM Cloudant DB

• IBM DB2 for z/OS

• Redis key-value connector

• MongoDB

• MySQL

• PostgreSQL

• Oracle

• Microsoft SQL

• REST services

• SOAP webservices

• Couchbase

• Neo4j

• SAP HANA

• ElasticSearch

Page 17: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

17

• IBM

DataPower

Gateway

Virtual

Edition

• API Connect

Manager

• API Connect

Portal

Docker Container

• µGateway

• API

Connect

Toolkit

IBM API Connect – Deployment possibilities

Physical ApplianceSoftware SolutionNode.JSVirtualisation

• IBM

DataPower

Gateway for

Docker

• API Connect

Manager

• API Connect

Portal

• IBM

DataPower

• IBM

DataPower

• API Connect on Cloud

(Managed instance)

And also …

Page 18: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

18

Hybrid Deployment – Your APIC with Co-located Gateways Anywhere

Customer Managed in Public Cloud

Customer Managed On-Premises

API Gateway

API

API Gateway

API

API Gateway

API

API Connect

API Gateway

API

Page 19: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

19

API Connect: Flexible licensing and deployment

Deployment

Deploy where it’s most convenient for you

• Deploy on IBM Bluemix

• Deploy to 3rd party clouds

• Deploy on-premises

Licensing

Pay only for what you need

• Subscription (API calls/month)

• Perpetual (per PVU, unlimited API calls)

Number of APIs & API Products Unlimited

Number of API Application Developers Unlimited

Cloud infrastructure on IBM Cloud Included

Data transfer on IBM Cloud Included

Page 20: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

20

Analyst view of Connect

IBM

in 2014

Gartner Full Lifecycle API Management MQ

IDC August 2016

IBM

in 2014

Forrester

November 2016Gartner October 2016

Page 21: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

21

Agenda

1. API – Understanding the space

2. API Connect

3. Sample implementations

4. Démonstration

Page 22: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

22

Samples - Public

https://developer.psa-peugeot-citroen.com/inc/

Page 23: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

23

Samples - Public

https://developer.fr.carrefour.io/

Page 24: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

24

Samples - Public

https://developer.royalmail.net/start

Page 25: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

25

Agenda

1. API – Understanding the space

2. API Connect

3. Sample implementations

4. Démonstration

Page 26: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

26

API Management Resources

• Product Page

– ibm.com/apimanagement

• API developer community

– developer.ibm.com/api

• Twitter

– @ibmapimgt

• YouTube Channel

– youtube.com/ibmapimanagement

• Slideshare

– slideshare.net/ibmapimgmt

• PSD2

– developer.ibm.com/apiconnect/2017/07/14/api-connect-delivers-open-banking-api-support-

psd2-requirements/

Page 27: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

27

Where to find information

• Proof of Technology – 1 day workshop

– http://www-05.ibm.com/fr/events/tec/new/Cloud.html

• Formation avec Arrow – 4 days training

– https://edu.arrow.com/fr/trainings/open/ibm/9/trainings_list.html

• Knowledge center

– http://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/mapfiles/getti

ng_started.html

• Github lab

– https://github.com/ADesprets/bluemix-labs/tree/master/Lab%20API%20-

%20Manage%20your%20APIs%20with%20API%20Connect

Page 28: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

28

DataPower Operations Dashboard

monitoring

Page 29: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

29

Démonstration - APIC

Page 30: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

30

Screen captures

Page 31: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

31

Developer Toolkit – Laptop Experience (API Designer)

Start at developer.ibm.com/apiconnect

Page 32: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

32

Create APIs

Page 33: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

33

Create APIs

Page 34: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

34

Create APIs

Page 35: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

35

Create APIs

Page 36: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

36API Toolkit to Create and Publish APIs, Products

API Toolkit commands

Page 37: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

37

API Policy Managementusing graphical & source views

Page 38: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

38

Policies

Page 39: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

39

Micro Gateway and DataPower Gateway Policies

Page 40: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

40

Source view

Page 41: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

41

Unit Test Assembly flow

Page 42: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

42

Cloud Manager

42

Page 43: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

43

Cloud Manager to configure and administer API Cloud

Page 44: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

44

Cloud Manager to configure and administer API Cloud

Page 45: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

45

API Manager console for API providers

Page 46: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

46

API Manager to configure and administer API Cloud

Page 47: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

47

Catalogs Dashboard

Page 48: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

4848

Manage Catalog

Page 49: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

49

For a catalog,

configure gateway clusters to stage & deploy Product/APIs

Page 50: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

50

For an environment,

manage portals to publish APIs

Page 51: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

51

For an environment,

manage permissions for approving lifecycle state changes

Page 52: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

52

API Provider user management

52

Page 53: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

53

Add and remove users,

assign roles & define custom roles

Page 54: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

54

Analytics Gain Business Insights

Page 55: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

55

Analytics: Active APIs and Products

Page 56: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

56

Analytics: Response times

Page 57: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

57

Analytics: API call volume

Page 58: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

58

Developer Portal for API Consumers

Page 59: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

59

Developer Portal

Page 60: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

60

Developer Portal

Page 61: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

61

Cloud

61

Page 62: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

62

API Connect comes to Bluemix

Page 63: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

63

IBM API Connect on BluemixAn integrated solution to manage the API lifecycle for all of your Bluemix APIs

Value: Create, Run, Secure, Control, Publish, Analyze and Manage your APIs.

Key Capabilities:

Create – create high-quality, scalable and secure

APIs for application servers, databases, enterprise

service buses (ESB) & mainframes in minutes

Run– Run—take advantage of integrated tooling to

build, debug and deploy APIs and microservices using

the Node.js or Java

Manage – create and manage portals that allow

developers to quickly discover and consume APIs and

securely access enterprise data, and monitor APIs to

improve performance

Secure - Secure—Administrators can manage

security and governance over APIs and the

microservices. IT can set and enforce API policies to

secure back-end information assets and comply with

governance and regulatory mandates

IBM Hybrid Integration Services

A Bluemix service which seamlessly launches an API Connect experience to extend your API reach

Page 64: Andorsoft, S.A. - API Connect · Open API –Swagger 2.0 •The OpenAPI Specification (aka Swagger Specification): specification for machine-readable interface files for describing,

64

Ovum