๐บ New oss vuln: spring-restdocs-restassured is vulnerable to XML External Entity (XXE) Injection ๐บ
Medium ๐ก / Java
intel.aikido.dev/cve/AIKIDO-โฆ
Once again I had to google for Andys webinar from 2015 why to use Spring ๐ Restdocs over Swagger/OpenAPI. Stumbled over this piece of "API docs". Can you spot the method signature in the mess of annotations? ๐๐คฆโโ๏ธ youtube.com/watch?v=knH5ihPNโฆ
New approach:
๐ธdiscuss the API with the client
๐ธwrite down that description in Asciidoc
๐ธwrite a Controller Test with Spring Test and Restdocs
๐ธimplement the API
๐ธPull generated snippets into the API documentation
โNo Word, No Confluence, No Emails
Asciidoc and RestDocs have become a staple in my organization to help not o my keep the developers honest but to alleviate onboarding discussions by providing an upfront, living document of exactly what we do.
It lives with our code, it evolves with it, and it's tested too!!
Improved the generated website for each microservice with
โ๏ธ REST API docs (Spring Restdocs)
โ๏ธ Database Schema (Schemaspy)
โ๏ธ Supporting Team, SCM, CI
less relevant:
โ๏ธ Javadocs
โ๏ธ Sonar
smth. missingโSLAโDeployment EnvironmentsโEvent Docโ#OpenWMS.org
openwms.github.io/org.openwmโฆ
Our open-source project `restdocs-api-spec` buff.ly/2SPW1H1 has 11 watchers, 74 stars, 22 forks, and 13 contributors already. That's amazing! Massive thanks to @zaddo who's taking care of all this!
only the infrastructure APIs for health and metrics - so that discussion comes finally to an end. All other microprofile APIs are broader or more elegant solved with Spring. Like DI, RestDocs, Feign, Config, Security, REST
Go @drtessak ! This is great exposure of issues for public awareness of what effects their care, exposes abusive cultural practices/cruel initiation rites and pushes for accountability for collective wellbeing by every level of medical hierarchy all at once. #restdocs#justice
Quick turn around yesterday from rice cereal crusted mum to live TV interview - unpacking unaccredited training, work safety and culture in medicine. Towards #resteddocs.
Spring Auto REST Docs release 2.0.3 is fresh out of oven with support for #hateoas and improved integration with classic snippets. Kotlin support is also getting better with improved KDoc extension @flbenz#restdocsgithub.com/ScaCap/spring-autโฆ
Spring REST Docs at #springio18 This time with restdocs-raml presented by @zaddo From RAML one can generate HTML documenting, an interactive API console, Postman collections and more.