Pakete, Repositories und App-Kategorien suchen

Paketdetailsv0.1.5

shelf_cors_headers

CORS-Kopfzeilen-Middleware für Shelf.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
41.700
Likes
41
Pub-Punkte
140

Paket installieren

flutter pub add shelf_cors_headers

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Shelf CORS Headers ist ein Middleware-Paket für den Shelf-Framework, das die Hinzufügung von Cross-Origin Resource Sharing (CORS)-Headern zu HTTP-Antworten vereinfacht. Es ermöglicht serverseitige Anwendungen, die mit Shelf erstellt wurden, sicher auf Anfragen aus anderen Ursprüngen zu reagieren, indem erlaubte Ursprünge, Methoden, Header und Anmeldeinformationen konfiguriert werden können. Das Paket lässt sich nahtlos in bestehende Shelf-basierte Server integrieren und bietet eine leichte und konfigurierbare Lösung zur Verwaltung von CORS-Richtlinien in Webdiensten über mehrere Plattformen hinweg.

Anwendungsfälle

  • Cross-Origin-Anfragen in Shelf-basierten APIs aktivieren
  • Sicherung von Webdiensten mit kontrollierten Zugriffsrichtlinien
  • Unterstützung von Frontend-Anwendungen, die auf verschiedenen Domänen gehostet werden
  • CORS in Flutter Web Backends integrieren
  • Automatische Behandlung von Preflight-Anfragen

Hauptmerkmale

  • Konfigurierbare zulässige Ursprünge
  • Unterstützung für benutzerdefinierte Header und Methoden
  • Automatische Behandlung von OPTIONS-Vorabprüfungsanfragen
  • Einfache Integration mit Shelf-Routern
  • Flexible Konfiguration für Anmeldeinformationen und maximales Alter

Geeignet für

  • Entwickler, die Shelf für Backend-Logik verwenden
  • Flutter-Entwickler, die Web-APIs erstellen
  • Teams, die sichere RESTful-Dienste implementieren
  • Anwendungen, die eine feinkörnige CORS-Steuerelemente erfordern
  • Serverseitige Dart-Projekte für mehrere Plattformen

Hinweise

  • Erfordert grundlegendes Verständnis der CORS-Standards
  • Nicht geeignet für eigenständige clientseitige Verwendung
  • Die Konfiguration muss in der Produktion sorgfältig verwaltet werden
  • Enthält keine Anforderungsüberprüfung über CORS hinaus
  • Beschränkt auf shelfbasierte Serverumgebungen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

CORS headers middleware for Shelf

A Shelf middleware to add CORS headers to shelf responses.

Features

  • Handles preflight requests.
  • Allows override of default headers.
  • Allows user to provide their own origin checker function.

Usage

A simple usage example:

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

void main() async {
  var handler = const Pipeline()
      // Just add corsHeaders() middleware.
      .addMiddleware(corsHeaders())
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}
Override Headers
import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    ACCESS_CONTROL_ALLOW_ORIGIN: 'example.com',
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your header overrides.
      .addMiddleware(corsHeaders(headers: overrideHeaders))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}
Custom origin checker

Your origin checker function should consume a string as a parameter(the value of ORIGIN header) and return a boolean value indicating if this middleware should process the request from that origin.

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

// define our origin checker
bool dontCheckCNNRequests(String origin) {
  if (origin.contains('cnn.com')) return false;
  return true;
}

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your origin checker
      .addMiddleware(corsHeaders(headers: overrideHeaders, originChecker: dontCheckCNNRequests))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}

You can also use the inbuilt originOneOf which takes a list of origins to check:

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

// define our origin checker
final listChecker = originOneOf(['https://cnn.com', 'https://dart.dev'])

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your origin checker
      .addMiddleware(corsHeaders(headers: overrideHeaders, originChecker: listChecker))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden