{"id":1069,"date":"2017-04-27T09:53:44","date_gmt":"2017-04-27T07:53:44","guid":{"rendered":"http:\/\/whiteducksoftware.com\/?p=1069"},"modified":"2021-12-07T15:55:18","modified_gmt":"2021-12-07T14:55:18","slug":"azure-ad-authentication-swagger-ui","status":"publish","type":"post","link":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/","title":{"rendered":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung"},"content":{"rendered":"

Swagger-UI Extension f\u00fcr Azure AD Authentifizierung<\/h2>\n

Bei verteilten Systemen, wie Cloud L\u00f6sungen, spielt die Generierung clientseitiger Proxies eine wichtige Rolle. Vor allem wenn die Middleware \u00f6ffentlich verf\u00fcgbar und von allen g\u00e4ngigen Sprachen konsumiert werden soll, wie es bei Cloud gehosteten API\u2019s zumeist der Fall ist.<\/p>\n

Grundlage f\u00fcr die Generierung clientseitiger Proxies ist eine plattform- und programmiersprachenunabh\u00e4ngige Beschreibungssprache der Netzwerkdienste. Bei RESTful Web services wird h\u00e4ufig die OpenAPI Spezifikation (fr\u00fcher bekannt als Swagger Spezifikation) f\u00fcr die Beschreibung der Dienste verwendet.<\/p>\n

Swashbuckle bietet f\u00fcr ASP.NET eine ausgereifte und quelloffene OpenAPI Implementierung, die auch eine Oberfl\u00e4che zum Testen der API (Swagger-UI) beinhaltet. Swagger-UI erm\u00f6glicht Benutzern \u00fcber eine Webseite mit API\u2018s zu interagieren ohne daf\u00fcr etwas implementieren zu m\u00fcssen.<\/p>\n

Kompliziert wird es, wenn Authentifizierung und Autorisierung der API ins Spiel kommen. Im Azure Umfeld wird daf\u00fcr h\u00e4ufig Azure Active Directory als Identity Management as a Service (IDaaS) verwendet. Der API Entwickler muss dann \u00fcber detailliertes OAuth2 Wissen verf\u00fcgen, einen geeigneten OAuth2 Flow ausw\u00e4hlen sowie einen Authentifizierungsfilter implementieren um die vom Azure Active Directory gesicherte API \u00fcber Swagger-UI aufrufen zu k\u00f6nnen.<\/p>\n

Das white duck NuGet Paket \u201eWhiteduck.Swagger.AADExtension<\/a>\u201c bietet eine Erweiterung der Swagger-Optionen an, um die Autentifizierung des Swagger-UI Clients mit dem Azure Active Directory zu vereinfachen. Der Benutzer kann sich nach Implementierung \u00fcber die Swagger-UI Client Applikation gegen das Azure Active Directory authentifizieren und hat damit Berechtigung die API aufzurufen.<\/p>\n

Weitere Informationen zur Anwendung des Pakets sowie weitere Projekt-Tools und Extensions finden sich bei GitHub: https:\/\/github.com\/whiteducksoftware\/whiteduck.swagger.aadextension<\/a><\/p>\n

\"\"<\/p>\n","protected":false},"excerpt":{"rendered":"

Swagger-UI Extension f\u00fcr Azure AD Authentifizierung Bei verteilten Systemen, wie Cloud L\u00f6sungen, spielt die Generierung clientseitiger Proxies eine wichtige Rolle. Vor allem wenn die Middleware \u00f6ffentlich verf\u00fcgbar und von allen g\u00e4ngigen Sprachen konsumiert werden soll, wie es bei Cloud gehosteten API\u2019s zumeist der Fall ist. Grundlage f\u00fcr die Generierung clientseitiger Proxies ist eine plattform- und <\/p>\n

[…]<\/div>\n

<\/a><\/p>\n","protected":false},"author":3,"featured_media":2884,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_tribe_events_control_status":"","_tribe_events_control_status_canceled_reason":"","_tribe_events_control_status_postponed_reason":"","_tribe_events_control_online":"","_tribe_events_control_online_url":"","footnotes":""},"categories":[],"tags":[113,114,117,125,126,127,128,129,131,132,133],"class_list":["post-1069","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","tag-azure","tag-azure-ad","tag-github","tag-idaas","tag-identity-managament","tag-nuget","tag-oauth2","tag-rest-api","tag-swagger","tag-swagger-ui","tag-swashbuckle"],"yoast_head":"\nSwagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck<\/title>\n<meta name=\"description\" content=\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck\" \/>\n<meta property=\"og:description\" content=\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/\" \/>\n<meta property=\"og:site_name\" content=\"white duck\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/whiteduckgmbh\" \/>\n<meta property=\"article:published_time\" content=\"2017-04-27T07:53:44+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-12-07T14:55:18+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif\" \/>\n\t<meta property=\"og:image:width\" content=\"1160\" \/>\n\t<meta property=\"og:image:height\" content=\"471\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/gif\" \/>\n<meta name=\"author\" content=\"Markus Suemmchen\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@whiteduck_gmbh\" \/>\n<meta name=\"twitter:site\" content=\"@whiteduck_gmbh\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Markus Suemmchen\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/\"},\"author\":{\"name\":\"Markus Suemmchen\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/#\\\/schema\\\/person\\\/7b00817228fc904e115ab1c0c68a335a\"},\"headline\":\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung\",\"datePublished\":\"2017-04-27T07:53:44+00:00\",\"dateModified\":\"2021-12-07T14:55:18+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/\"},\"wordCount\":278,\"commentCount\":111,\"image\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/whiteduck.de\\\/wp-content\\\/uploads\\\/azure-ad-swagger-ui.gif\",\"keywords\":[\"Azure\",\"Azure AD\",\"GitHub\",\"IDaaS\",\"Identity Managament\",\"NuGet\",\"OAuth2\",\"REST API\",\"Swagger\",\"Swagger-UI\",\"Swashbuckle\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/\",\"url\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/\",\"name\":\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/whiteduck.de\\\/wp-content\\\/uploads\\\/azure-ad-swagger-ui.gif\",\"datePublished\":\"2017-04-27T07:53:44+00:00\",\"dateModified\":\"2021-12-07T14:55:18+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/#\\\/schema\\\/person\\\/7b00817228fc904e115ab1c0c68a335a\"},\"description\":\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#primaryimage\",\"url\":\"https:\\\/\\\/whiteduck.de\\\/wp-content\\\/uploads\\\/azure-ad-swagger-ui.gif\",\"contentUrl\":\"https:\\\/\\\/whiteduck.de\\\/wp-content\\\/uploads\\\/azure-ad-swagger-ui.gif\",\"width\":1160,\"height\":471},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/azure-ad-authentication-swagger-ui\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Startseite\",\"item\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/#website\",\"url\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/\",\"name\":\"white duck\",\"description\":\"Your Partner for Microsoft Azure & AI\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/#\\\/schema\\\/person\\\/7b00817228fc904e115ab1c0c68a335a\",\"name\":\"Markus Suemmchen\",\"sameAs\":[\"https:\\\/\\\/whiteduck.de\"],\"url\":\"https:\\\/\\\/whiteduck.de\\\/en\\\/author\\\/markus-suemmchen\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck","description":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/","og_locale":"en_US","og_type":"article","og_title":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck","og_description":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.","og_url":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/","og_site_name":"white duck","article_publisher":"https:\/\/www.facebook.com\/whiteduckgmbh","article_published_time":"2017-04-27T07:53:44+00:00","article_modified_time":"2021-12-07T14:55:18+00:00","og_image":[{"width":1160,"height":471,"url":"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif","type":"image\/gif"}],"author":"Markus Suemmchen","twitter_card":"summary_large_image","twitter_creator":"@whiteduck_gmbh","twitter_site":"@whiteduck_gmbh","twitter_misc":{"Written by":"Markus Suemmchen","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#article","isPartOf":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/"},"author":{"name":"Markus Suemmchen","@id":"https:\/\/whiteduck.de\/en\/#\/schema\/person\/7b00817228fc904e115ab1c0c68a335a"},"headline":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung","datePublished":"2017-04-27T07:53:44+00:00","dateModified":"2021-12-07T14:55:18+00:00","mainEntityOfPage":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/"},"wordCount":278,"commentCount":111,"image":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#primaryimage"},"thumbnailUrl":"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif","keywords":["Azure","Azure AD","GitHub","IDaaS","Identity Managament","NuGet","OAuth2","REST API","Swagger","Swagger-UI","Swashbuckle"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/","url":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/","name":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung - white duck","isPartOf":{"@id":"https:\/\/whiteduck.de\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#primaryimage"},"image":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#primaryimage"},"thumbnailUrl":"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif","datePublished":"2017-04-27T07:53:44+00:00","dateModified":"2021-12-07T14:55:18+00:00","author":{"@id":"https:\/\/whiteduck.de\/en\/#\/schema\/person\/7b00817228fc904e115ab1c0c68a335a"},"description":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung.","breadcrumb":{"@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#primaryimage","url":"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif","contentUrl":"https:\/\/whiteduck.de\/wp-content\/uploads\/azure-ad-swagger-ui.gif","width":1160,"height":471},{"@type":"BreadcrumbList","@id":"https:\/\/whiteduck.de\/en\/azure-ad-authentication-swagger-ui\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Startseite","item":"https:\/\/whiteduck.de\/en\/"},{"@type":"ListItem","position":2,"name":"Swagger-UI Extension f\u00fcr Azure AD Authentifizierung"}]},{"@type":"WebSite","@id":"https:\/\/whiteduck.de\/en\/#website","url":"https:\/\/whiteduck.de\/en\/","name":"white duck","description":"Your Partner for Microsoft Azure & AI","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/whiteduck.de\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/whiteduck.de\/en\/#\/schema\/person\/7b00817228fc904e115ab1c0c68a335a","name":"Markus Suemmchen","sameAs":["https:\/\/whiteduck.de"],"url":"https:\/\/whiteduck.de\/en\/author\/markus-suemmchen\/"}]}},"_links":{"self":[{"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/posts\/1069","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/comments?post=1069"}],"version-history":[{"count":0,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/posts\/1069\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/media\/2884"}],"wp:attachment":[{"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/media?parent=1069"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/categories?post=1069"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/whiteduck.de\/en\/wp-json\/wp\/v2\/tags?post=1069"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}