Home | History | Annotate | Download | only in identity 
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CHROME_BROWSER_EXTENSIONS_API_IDENTITY_WEB_AUTH_FLOW_H_
      6 #define CHROME_BROWSER_EXTENSIONS_API_IDENTITY_WEB_AUTH_FLOW_H_
      7 
      8 #include <string>
      9 
     10 #include "apps/app_window_registry.h"
     11 #include "content/public/browser/notification_observer.h"
     12 #include "content/public/browser/notification_registrar.h"
     13 #include "content/public/browser/web_contents_observer.h"
     14 #include "ui/gfx/rect.h"
     15 #include "url/gurl.h"
     16 
     17 class Profile;
     18 class WebAuthFlowTest;
     19 
     20 namespace content {
     21 class NotificationDetails;
     22 class NotificationSource;
     23 class RenderViewHost;
     24 class WebContents;
     25 }
     26 
     27 namespace extensions {
     28 
     29 // Controller class for web based auth flows. The WebAuthFlow creates
     30 // a dialog window in the scope approval component app by firing an
     31 // event. A webview embedded in the dialog will navigate to the
     32 // |provider_url| passed to the WebAuthFlow constructor.
     33 //
     34 // The WebAuthFlow monitors the WebContents of the webview, and
     35 // notifies its delegate interface any time the WebContents navigates
     36 // to a new URL or changes title. The delegate is expected to delete
     37 // the flow when navigation reaches a known target location.
     38 //
     39 // The window is not displayed until the first page load
     40 // completes. This allows the flow to complete without flashing a
     41 // window on screen if the provider immediately redirects to the
     42 // target URL.
     43 //
     44 // A WebAuthFlow can be started in Mode::SILENT, which never displays
     45 // a window. If a window would be required, the flow fails.
     46 class WebAuthFlow : public content::NotificationObserver,
     47                     public content::WebContentsObserver,
     48                     public apps::AppWindowRegistry::Observer {
     49  public:
     50   enum Mode {
     51     INTERACTIVE,  // Show UI to the user if necessary.
     52     SILENT        // No UI should be shown.
     53   };
     54 
     55   enum Failure {
     56     WINDOW_CLOSED,  // Window closed by user.
     57     INTERACTION_REQUIRED,  // Non-redirect page load in silent mode.
     58     LOAD_FAILED
     59   };
     60 
     61   class Delegate {
     62    public:
     63     // Called when the auth flow fails. This means that the flow did not result
     64     // in a successful redirect to a valid redirect URL.
     65     virtual void OnAuthFlowFailure(Failure failure) = 0;
     66     // Called on redirects and other navigations to see if the URL should stop
     67     // the flow.
     68     virtual void OnAuthFlowURLChange(const GURL& redirect_url) = 0;
     69     // Called when the title of the current page changes.
     70     virtual void OnAuthFlowTitleChange(const std::string& title) = 0;
     71 
     72    protected:
     73     virtual ~Delegate() {}
     74   };
     75 
     76   // Creates an instance with the given parameters.
     77   // Caller owns |delegate|.
     78   WebAuthFlow(Delegate* delegate,
     79               Profile* profile,
     80               const GURL& provider_url,
     81               Mode mode);
     82 
     83   virtual ~WebAuthFlow();
     84 
     85   // Starts the flow.
     86   virtual void Start();
     87 
     88   // Prevents further calls to the delegate and deletes the flow.
     89   void DetachDelegateAndDelete();
     90 
     91  private:
     92   friend class ::WebAuthFlowTest;
     93 
     94   // ::AppWindowRegistry::Observer implementation.
     95   virtual void OnAppWindowAdded(apps::AppWindow* app_window) OVERRIDE;
     96   virtual void OnAppWindowRemoved(apps::AppWindow* app_window) OVERRIDE;
     97 
     98   // NotificationObserver implementation.
     99   virtual void Observe(int type,
    100                        const content::NotificationSource& source,
    101                        const content::NotificationDetails& details) OVERRIDE;
    102 
    103   // WebContentsObserver implementation.
    104   virtual void DidStopLoading(content::RenderViewHost* render_view_host)
    105       OVERRIDE;
    106   virtual void DidNavigateMainFrame(
    107       const content::LoadCommittedDetails& details,
    108       const content::FrameNavigateParams& params) OVERRIDE;
    109   virtual void RenderProcessGone(base::TerminationStatus status) OVERRIDE;
    110   virtual void DidStartProvisionalLoadForFrame(
    111       int64 frame_id,
    112       int64 parent_frame_id,
    113       bool is_main_frame,
    114       const GURL& validated_url,
    115       bool is_error_page,
    116       bool is_iframe_srcdoc,
    117       content::RenderViewHost* render_view_host) OVERRIDE;
    118   virtual void DidFailProvisionalLoad(int64 frame_id,
    119                                       const base::string16& frame_unique_name,
    120                                       bool is_main_frame,
    121                                       const GURL& validated_url,
    122                                       int error_code,
    123                                       const base::string16& error_description,
    124                                       content::RenderViewHost* render_view_host)
    125       OVERRIDE;
    126 
    127   void BeforeUrlLoaded(const GURL& url);
    128   void AfterUrlLoaded();
    129 
    130   Delegate* delegate_;
    131   Profile* profile_;
    132   GURL provider_url_;
    133   Mode mode_;
    134 
    135   apps::AppWindow* app_window_;
    136   std::string app_window_key_;
    137   bool embedded_window_created_;
    138 
    139   content::NotificationRegistrar registrar_;
    140 
    141   DISALLOW_COPY_AND_ASSIGN(WebAuthFlow);
    142 };
    143 
    144 }  // namespace extensions
    145 
    146 #endif  // CHROME_BROWSER_EXTENSIONS_API_IDENTITY_WEB_AUTH_FLOW_H_
    147