Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add essential Kafka client security config #447

Merged
merged 5 commits into from
Oct 11, 2021

Conversation

dalelane
Copy link

@dalelane dalelane commented Oct 3, 2021

This commit updates the HTML generated by the react template
so that it includes essential Kafka config required for clients.

This makes it easier for someone using HTML docs generated from
AsyncAPI docs to get started creating a Kafka client.

Signed-off-by: Dale Lane [email protected]

This commit updates the HTML generated by the react template
so that it includes essential Kafka config required for clients.

This makes it easier for someone using HTML docs generated from
AsyncAPI docs to get started creating a Kafka client.

Signed-off-by: Dale Lane <[email protected]>
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Welcome to AsyncAPI. Thanks a lot for creating your first pull request. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.

Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.

@dalelane
Copy link
Author

dalelane commented Oct 3, 2021

inspired by a discussion on Slack
https://asyncapi.slack.com/archives/C0230UAM6R3/p1631889206093800

similar to a pull request I created for markdown-template
asyncapi/markdown-template#174

@dalelane
Copy link
Author

dalelane commented Oct 3, 2021

Example output:

asyncapi: '2.2.0'
info:
  title: Streetlights Kafka API
  version: '1.0.0'
  description: |
    The Smartylighting Streetlights API allows you to remotely manage the city lights.

servers:
  test:
    url: test.mykafkacluster.org:8092
    protocol: kafka
    description: Test broker

results in this from @asyncapi/html-template

image

@dalelane
Copy link
Author

dalelane commented Oct 3, 2021

Example output:

asyncapi: '2.2.0'
info:
  title: Streetlights Kafka API
  version: '1.0.0'
  description: |
    The Smartylighting Streetlights API allows you to remotely manage the city lights.

servers:
  test:
    url: test.mykafkacluster.org:8092
    protocol: kafka-secure
    description: Test broker

results in this from @asyncapi/html-template

image

@dalelane
Copy link
Author

dalelane commented Oct 3, 2021

Example output:

asyncapi: '2.2.0'
info:
  title: Streetlights Kafka API
  version: '1.0.0'
  description: |
    The Smartylighting Streetlights API allows you to remotely manage the city lights.

servers:
  test:
    url: test.mykafkacluster.org:8092
    protocol: kafka-secure
    description: Test broker
    security:
      - saslScram: []

components:
  securitySchemes:
    saslScram:
      type: scramSha256
      description: create credentials in the dev portal

results in this from @asyncapi/html-template

image

Copy link
Member

@magicmatatjahu magicmatatjahu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dalelane Thanks for contribution! I'm not an expert in security and thanks for rendering it the way it needs to be. For 2.1 I just rendered new security types, so thank you!

Please refer to my suggestions, overall good, but we can improve some parts :)

library/src/containers/Servers/ServerSecurity.tsx Outdated Show resolved Hide resolved
library/src/containers/Servers/ServerSecurity.tsx Outdated Show resolved Hide resolved
library/src/containers/Servers/ServerSecurity.tsx Outdated Show resolved Hide resolved
library/src/containers/Servers/ServerSecurity.tsx Outdated Show resolved Hide resolved
dalelane and others added 2 commits October 5, 2021 15:10
Styling improvement requested in review

Co-authored-by: Maciej Urbańczyk <[email protected]>
@dalelane
Copy link
Author

dalelane commented Oct 5, 2021

Thanks for the review! I've added commits to address the bits you caught.

Copy link
Member

@magicmatatjahu magicmatatjahu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thanks for contribution!

@dalelane Sorry, we have a problem 😅 Could you run lint npm run lint:fix to fix linter errors and push changes? While pushing the suggestions I forgot that there might be a problem with the linter. And sorry for the delay with the second review.

Signed-off-by: Dale Lane <[email protected]>
@sonarqubecloud
Copy link

sonarqubecloud bot commented Oct 8, 2021

Kudos, SonarCloud Quality Gate passed!    Quality Gate passed

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

@magicmatatjahu magicmatatjahu merged commit 072659e into asyncapi:next Oct 11, 2021
@magicmatatjahu
Copy link
Member

@all-contributors please add @dalelane for code, ideas

@allcontributors
Copy link
Contributor

@magicmatatjahu

I've put up a pull request to add @dalelane! 🎉

@asyncapi-bot
Copy link
Contributor

🎉 This PR is included in version 1.0.0-next.21 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants