apidays LIVE Australia 2020 - Building Business Ecosystems Federating API Development at Australia’s largest business bank Jason D'Souza, Senior Architect – API Gateways, & Lynne Lee, Senior Analyst, Engineer at NAB

1. FEDERATING API DEVELOPMENT
AT AUSTRALIA’S LARGEST
BUSINESS BANK
Presented by Jason D’Souza & Lynne Lee, National Australia Bank
September 2020

2. JASON D’SOUZA
SENIOR ARCHITECT – API GATEWAYS
ABOUT US
2
LYNNE LEE
SENIOR ANALYST - ENGINEER
l 5 Years at NAB
l Used to be an avid traveller
l Looks after NAB API Ecosystem
l 13 Years at NAB
l BBQ Pitmaster wannabe
l Owner of NAB API Ecosystem

3. TWO YEARS AGO

4. 4
NAB API
MANAGEMENT PLATFORM
We should work hard to keep the number of words on
every page to a minimum. We want them listening to
you, not reading every word on the page.
Keep paragraphs short and concise, and use a maximum
of six bullet points per page.
To replace the image, select and delete. Then click on
the icon in the image placeholder frame and select your
own image from file. Or you can drag & drop the image
into the placeholder.
A SaaS offering comprised of integrated tooling for API
Consumers and API Publishers across all stages of the API
Lifecycle
l Design
l Deploy
l Run
l Manage
l Discover

5. 5
NAB API ARCHITECTURE

6. DEPLOY

7. 7
DEPLOY: DECREASING DEV EFFORT WITH A CLI TOOL (SWAGSTAR)
l Abstracts the gateway technology
l Enforces API standards
l Uses swagger 2/OAS3 documentation as
input
l Easy management of
multiple environments
l Updates the central API registry (Stargaze)
automatically
l Designed to work well in CI/CD Pipelines
API Gateway
Env 1
CLI (Swagstar)
-abstracts gateway tech
- API Standards Validation
- swagger docs as input
central API
registry
(Stargaze)
deploy
Publish docs
API Gateway
Env 2
deploy

8. DEV TEAM 1: TALKING SERVICE DEV TEAM 2: WALKING SERVICE
EASY TEAM COLLABORATION: A SILLY EXAMPLE – ROBOT TENANCY
8
• Dev Angie: Questioning Function
• Dev Bob: Answering Function
• Dev Chris: Left function
• Dev Danielle: Right function

9. 9
DEV TEAM 1: TALKING SERVICE
Questioning
Code
Works on
Dev
Angie
Questioning
APIs Swagger
Generates
Service Config
File
Answering CodeWorks on
Answering
APIs Swagger
Generates
Dev Bob
Talking Service

10. 10
DEV TEAM 1: TALKING SERVICE,
QUESTIONING SWAGGER

11. 11
NAB API ARCHITECTURE

12. 12
DEV/TESTING FLOW
Devs push
code that
changes APIs
Triggers
deployment
pipelines
CLI Tool
validates API
spec & deploys
changes to
test environment
Run pipelines
to deploy to
other environments
Changes needed?
Production
Testing

13. 13
TALKING SERVICE: SERVICE CONFIG FILE

14. 14
ROBOT SERVICE API GATEWAY
Talking API Service
- /v1/robot/talking/greeting
- /v1/robot/talking/friendly
- /v1/robot/talking/yesno
- /v1/robot/talking/star
Walking API Service
- /v1/robot/walking/left
- /v1/robot/walking/right
Service API Gateway
IDP
IDP Token
Incoming Request
Talking
Service
Walking
Service

15. 15
CLIENT API GATEWAY
Robot
Talking
Service
Robot
Walking
Service
Robot Tenant
Robot
Service API Gateway
Accounts
Service
Account
Details
Service
Account Mgmt
Service API Gateway
Account Mgmt Tenant
Client API Gateway
Robot Service Backends Account Mgmt Service Backends
Session Management
Customers

16. DISCOVER & ACCESS

17. 17
API DEVELOPER PORTAL API DISCOVERY

18. 18
API DEVELOPER PORTAL API DISCOVERY

19. 19
API CONSUMPTION PERFORMED BY THE CLIENT
Acquire Security/Access
Group Membership
Create Client Request Scopes
Scope Approval
Emails Sent
Scope Owner
Approves
Scopes Applied
to Client
Receive Client ID
& Secret

20. 20
API DEVELOPER PORTAL API CLIENT MANAGEMENT

21. 21
API DEVELOPER PORTAL CLIENT CREATION

22. 22
API DEVELOPER PORTAL CLIENT CREATION

23. 23
API DEVELOPER PORTAL API ACCESS (SCOPE REQUEST)

24. 24
API DEVELOPER PORTAL API MANAGEMENT

25. BENEFITS & LEARNINGS

26. 360
490
690
FY18 FY19 FY20
increased capability to deliver
new APIs and major versions
since 2018
92%
FROM IDEATION
TO PRODUCTION IN DAYS
FROM WEEKS AND MONTHS
> Significantly faster delivery
(Bottlenecks removed)
> Better scaling (API
development capacity by
number of teams not size
of a team)
> Unlocked Innovation
(cheaper and faster delivery
enables experimentation)
FEDERATION UNLOCKED
OUR CAPABILITY
TO DELIVER MORE AND FASTER
Cheaper and faster delivery
enables us to experiment
quickly to focus on better
customer and colleague
outcomes.
INNOVATION ENABLER
REALISED
BENEFITS

27. LEARNINGS TO SHARE
27
INVEST EARLY AND OFTEN IN
AUTOMATED GOVERNANCE
UNDERSTAND YOUR VALUE
PROPOSITION
IDENTIFY AND BUILD UP
ENGINEERING CAPABILITY
Consistent high quality APIs are
delivered into production through
automated checks – not through
manual bottlenecks
Strong product management
through working with your
customers to focus on delivering
the value most needed now
Focus on building maturity within
the engineering teams who have
low maturity in API design and
development

28. THANKYOU

29. QUESTIONS?