@sfdocs-internal/api-security-documentation

Documentation view for AMF security description

1.0.6

unpublished

latest

source

npm

Version published: last year

Maintainers: 17

Created: 2 years ago

Readme

Source

DEPRECATED

This component is being deprecated. The code base has been moved to amf-components module. This module will be archived when PR 1 is merged.

Documentation view for AMF security model of an API.

Version compatibility

This version only works with AMF model version 2 (AMF parser >= 4.0.0). For compatibility with previous model version use 3.x.x version of the component.

Usage

Installation

npm install --save @api-components/api-security-documentation

The component requires to set 2 properties: amf and security. The amf property is the whole API model generated by the AMF parser. This property is used to resolve compact moodel's keys. The security property is the part of the API model describing security method. The shape type is http://a.ml/vocabularies/security#SecurityScheme.

In an html file

<html>
  <head>
    <script type="module">
      import '@api-components/api-security-documentation/api-security-documentation.js';
    </script>
  </head>
  <body>
    <api-security-documentation amf="..." security="..."></api-security-documentation>
  </body>
</html>

In a LitElement

import { LitElement, html } from 'lit-element';
import '@api-components/api-security-documentation/api-security-documentation.js';

class SampleElement extends PolymerElement {
  static get properties() {
    return {
      // AMF model for selected security
      security: { type: Object }
    };
  }
  render() {
    return html`
    <api-security-documentation .amf="${this.amf}" .security="${this.security}"></api-security-documentation>
    `;
  }
}
customElements.define('sample-element', SampleElement);

Development

git clone https://github.com/advanced-rest-client/api-security-documentation
cd api-security-documentation
npm install

Running the demo locally

npm start

Running the tests

npm test

Keywords

FAQs

What is @sfdocs-internal/api-security-documentation?

Is @sfdocs-internal/api-security-documentation well maintained?

Last updated on 21 Apr 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install