[📑 Docs]: Adapt Server Security tutorial for v3

[jonaslagoni]

For AsyncAPI v3, we need to adapt the AsyncAPI Documents tutorial (https://www.asyncapi.com/docs/tutorials/getting-started/security) to be usable with AsyncAPI v3.

Here are the v3 structure that should be used instead:

asyncapi: 3.0.0
info:
  title: Hello world application
  version: '0.1.0'

servers:
  production:
    host: broker.mycompany.com
    protocol: amqp
    description: This is "My Company" broker.
    security:
      - $ref: "#/components/securitySchemes/user-password"

channels:
  hello:
    address: 'hello'
    messages:
      sayHelloMessage:
        $ref: '#/components/messages/hello-msg'

  goodbye:
    address: 'goodbye'
    messages:
      sayGoodbyeMessage:
        $ref: '#/components/messages/goodbye-msg'

operations:
  receiveHello:
    action: 'receive'
    channel:
      $ref: '#/channels/hello'

  receiveGoodbye:
    action: 'receive'
    channel:
      $ref: '#/channels/goodbye'

components:
  messages:
    hello-msg:
      payload:
        type: object
        properties:
          name:
            type: string
          sentAt:
            $ref: '#/components/schemas/sent-at'
    goodbye-msg:
      payload:
        type: object
        properties:
          sentAt:
            $ref: '#/components/schemas/sent-at'

  schemas:
    sent-at:
      type: string
      description: The date and time a message was sent.
      format: datetime
  securitySchemes:
    user-password:
      type: userPassword

Here are the main points that need to change:

• Re-add the docs/tutorials/getting-started/security.md file.
• Adapt the AsyncAPI code snippet
• Adapt the text if anything is needed.

Make sure you base your change on the next-major-spec branch and target it in your PR 🙂 If you have any questions, don't hesitate to ask.

[derberg]

solved with #2305
in next major branch, but considered to be fixed and closing - also for easier management of the scope for v3