Start implementing an auth flow for platform apps to be able to do auth

chrome/browser/extensions/api/identity/extension_auth_flow.h

+// Copyright (c) 2012 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_
+#define CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_
+#pragma once
+
+#include <string>
+#include <vector>
+
+#include "base/memory/scoped_ptr.h"

[Mihai Parparita -not on Chrome, 2012/05/08 21:33:30]

You can remove this.

[Munjal (Google), 2012/05/11 18:53:33]

Done.

+#include "content/public/browser/web_contents_delegate.h"
+#include "googleurl/src/gurl.h"
+#include "ui/views/widget/widget_delegate.h"
+
+namespace content {
+class BrowserContext;
+class WebContents;
+}
+
+namespace views {
+class WebView;
+class Widget;
+}
+
+namespace extensions {
+
+// Controller class to perform an auth flow with a provider.
+// This is the class to start the auth flow and it takes care of all the
+// details. It behaves the following way:
+// Given a provider URL, load the URL and perform usual web navigation
+// until it results in redirection to a valid extension redirect URL.
+// The provider can show any UI to the user if needed before redirecting
+// to an appropriate URL.
+// TODO(munjal): Add link to the design doc here.
+class ExtensionAuthFlow : public content::WebContentsDelegate,
+                          public views::WidgetDelegate {
+ public:
+  class Delegate {
+   public:
+    // Called when the auth flow is completed successfully.
+    // |redirect_url| is the full URL the provider redirected to at the end
+    // of the flow.
+    virtual void OnAuthFlowSuccess(const std::string& redirect_url) = 0;
+    // Called when the auth flow fails. This means that the flow did not result
+    // in a successful redirect to a valid redirect URL or the user canceled
+    // the flow.
+    virtual void OnAuthFlowFailure() = 0;
+  };
+
+  // Creates an instance with the given parameters.
+  // Caller owns |delegate|.
+  ExtensionAuthFlow(Delegate* delegate,
+                    content::BrowserContext* browser_context,
+                    const std::string& extension_id,
+                    const GURL& provider_url);
+  ~ExtensionAuthFlow();
+
+  // Starts the flow.
+  // Delegate will be called when the flow is done.
+  void Start();
+
+ protected:
+  virtual content::WebContents* CreateWebContents();
+
+ private:
+  // WebContentsDelegate implementation.
+  virtual void LoadingStateChanged(content::WebContents* source) OVERRIDE;
+  virtual void NavigationStateChanged(
+      const content::WebContents* source, unsigned changed_flags) OVERRIDE;
+
+  // WidgetDelegate implementation.
+  virtual views::View* GetContentsView() OVERRIDE;
+  virtual views::Widget* GetWidget() OVERRIDE;
+  virtual const views::Widget* GetWidget() const OVERRIDE;
+  virtual views::View* GetInitiallyFocusedView() OVERRIDE;
+  virtual void DeleteDelegate() OVERRIDE;
+
+  void OnUrlLoaded();
+  // Reports the results back to the delegate.
+  void ReportResult(const GURL& result);
+  // Helper to initialize valid extensions URLs vector.
+  void InitValidRedirectUrlPrefixes(const std::string& extension_id);
+  // Checks if |url| is a valid redirect URL for the extension.
+  bool IsValidRedirectUrl(const GURL& url) const;
+
+  Delegate* delegate_;
+  content::BrowserContext* browser_context_;
+  GURL provider_url_;
+  // List of valid redirect URL prefixes.
+  std::vector<std::string> valid_prefixes_;
+
+  content::WebContents* contents_;
+  views::Widget* widget_;
+  views::WebView* web_view_;
+
+  DISALLOW_COPY_AND_ASSIGN(ExtensionAuthFlow);
+};
+
+}  // namespace extensions
+
+#endif  // CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_