chef_fixie 0.1.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0ad2fbe46207502fef6aebd84a4f65c5143a691d
-  data.tar.gz: fcf34e96d4579c85ea02442bd7d17358269a8c16
+SHA256:
+  metadata.gz: 2b7aaa7e7efbd722314241465a721c57ed73c0abdfab5f13dcd7a1ddd3058157
+  data.tar.gz: 1b5c3d001760bb3e2cee276bee33b8a49521af5e91604910c3d1d49f07c20d0d
 SHA512:
-  metadata.gz: 891bf79ac2dfcac0bc3ab28d3439e54bb1b5431b977a876573ba196c5254e3d5d07a6015f5c859c44427912ebfd732284e51dec9c176cf22a934cb0f3bd5b525
-  data.tar.gz: 02adb68b623cd13142463329b359f0aaf141eb7b0e095aa1c9ecf82f7b6f826c6140982084fdc3d842f583eaeff0ce8f27f8ffa53de38fbb615857ab71e28d6b
+  metadata.gz: c12b81f65474fd9691018a4e0aeea14e247ea108aee4cd71563412949c76047c0568b9e4aebb65eadc2bfba15ad33b4e15984718e3473cdd70d9f5cb6baea131
+  data.tar.gz: 259ed111d9a4ca24437f2eb2c6091a86d97b07bfee10ce4085ee08a0b289eea58ff95128c60b58c4f2af14980debc118f2f58b03d582ea67d3a0714af2450acd

data/bin/chef_fixie

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
-require 'chef_fixie/console'
+require_relative "../lib/chef_fixie/console"
 
-Fixie::Console.start
+ChefFixie::Console.start

data/doc/AccessingSQL.md

@@ -5,7 +5,22 @@ Basics:
 Underneath everything is the Ruby Sequel library; there are a number
 of ways to access it.
 
-Check out http://ricostacruz.com/cheatsheets/sequel.html and 
+Check out http://ricostacruz.com/cheatsheets/sequel.html or the Sequel
+gem docs for details of the sequel library.
+
+Many objects in fixie have the accessor inner, which exposes the
+Sequel selector. This includes:
+* The constants ORGS, USERS, ASSOCIATIONS, and INVITES
+```ruby
+ORGS.inner.first
+#< @values={:id=>"7ddaee6b42e8f6a0a8e9d5d5efe644f8", :authz_id=>"f46b2e53869968ce115b97d2fd8bfee0", :name=>"ponyville", :full_name=>"ponyville", :assigned_at=>2015-07-21 18:22:34 UTC, :last_updated_by=>"08076ed32f7d5c62721607dd2c309c55", :created_at=>2015-07-21 18:22:34 UTC, :updated_at=>2015-07-21 18:22:34 UTC}>
+```
+* Any of the by_XXXX accessors
+```ruby
+ORGS['
+
+
+```
 
 
 
@@ -34,3 +49,20 @@ now = Sequel.function(:NOW)
 ASSOCS.inner.insert(:org_id=>o.id, :user_id=>u.id, :last_updated_by=>pivotal.authz_id,
 	:created_at=>now, :updated_at=>now )
 ```
+
+
+* Fixing a group that lost its authz object.
+We've seen the users group in hosted loose it's authz entry
+
+```ruby
+a = Fixie::AuthzApi.new
+# create a new authz group
+g = a.post("groups",{})
+# check that only one group is returned
+ORGS['acme'].groups.by_name('users').inner.all
+# alter the group and insert the new authz id
+ORGS['acme'].groups.by_name('users').inner.update(:authz_id=>g.id)
+```
+
+This does not add the users back to the usergs group, or re-add users
+all the acls that used to have the users group in them.

data/doc/BulkFixup.md

@@ -0,0 +1,33 @@
+Restoring acl permissions globally
+============
+
+If a key group is deleted (such as users)
+
+* Verify that the org has issues
+
+* Create/restore the group
+(TBW)
+
+* Add the users/groups back to the group
+(TBW)
+
+* Set the group ACL appropriately
+```ruby
+users_group.ace_add([:create,:read,:update,:delete], org.groups['admins'])
+users_group.ace_add([:create,:read,:update,:delete], USERS['pivotal'])
+```
+
+* Restore users to the appropriate container ACLs
+```ruby
+org = ORGS[THE_ORG]
+cl = %w(cookbooks data nodes roles environments policies policy_groups cookbook_artifacts)
+cl.each {|c| o.containers[c].ace_add([:create,:read,:update,:delete], org.groups['users']) }
+%w(clients).each { |c| org.containers[c].ace_add([:read,:delete], org.groups['users']) }
+%w(groups containers).each { |c| org.containers[c].ace_add([:read], org.groups['users']) }
+%w(sandboxes).each { |c| org.containers[c].ace_add([:create], org.groups['users']) }
+```
+
+* Then update the objects from the containers:
+```ruby
+Fixie::BulkEditPermissions::copy_from_containers(org)
+```

data/doc/CommonTasks.md

@@ -9,12 +9,23 @@ points
 
 First of all, run the automated org association checker:
 
-fixie:0 > Fixie::CheckOrgAssociations.check_associations("acme")
-Org acme is ok (6 users)
+    fixie:0 > Fixie::CheckOrgAssociations.check_associations("acme")
+    Org acme is ok (6 users)
 
 If it reports a problem with a user, you may be able to fix it
 automatically:
 
-fixie:0 > Fixie::CheckOrgAssociations.fix_association("acme", "mary")
+    fixie:0 > Fixie::CheckOrgAssociations.fix_association("acme", "mary")
 
 This might need to be run multiple times to fix all of the errors.
+
+
+Removing a user completely from an org
+-----------
+
+    [1] fixie(main)> ChefFixie::CheckOrgAssociations.remove_association('the_org', 'the_user')
+
+This removes the user from the org, and removes them from all org
+groups. However, if the user has been individually added to an ACL we
+don't fix that up; it would require enumeration of the whole org, and
+that hasn't been implemented.

data/lib/chef_fixie.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2014-2015 Chef Software Inc. 
+# Copyright (c) 2014-2015 Chef Software Inc.
 # License :: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -16,12 +16,13 @@
 #
 # Author: Mark Anderson <mark@chef.io>
 
-require 'sequel'
-require 'chef_fixie/config'
-require 'chef_fixie/sql'
-require 'chef_fixie/sql_objects'
+require "sequel"
+require_relative "chef_fixie/config"
+require_relative "chef_fixie/sql"
+require_relative "chef_fixie/sql_objects"
 
 # This doesn't work because of initialization order, figure it out.
-require 'chef_fixie/check_org_associations'
+require_relative "chef_fixie/check_org_associations"
+require_relative "chef_fixie/bulk_edit_permissions"
 
 Sequel.extension :inflector

data/lib/chef_fixie/authz_mapper.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2014-2015 Chef Software Inc. 
+# Copyright (c) 2014-2015 Chef Software Inc.
 # License :: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -17,9 +17,9 @@
 # Author: Mark Anderson <mark@chef.io>
 #
 
-require 'pp'
-require 'chef_fixie/config'
-require 'chef_fixie/authz_objects'
+require "pp"
+require_relative "config"
+require_relative "authz_objects"
 
 module ChefFixie
   module AuthzMapper
@@ -32,7 +32,7 @@ module ChefFixie
     #
     # Much of this might be better folded up into a sql stored procedure
     #
-   
+
     def self.included(base)
       base.extend(ClassMethods)
     end
@@ -44,9 +44,9 @@ module ChefFixie
       if objects.count == 1
         object = objects.first
         name = object.name
-        scope = 
-          if object.respond_to?(:org_id) 
-              ChefFixie::Sql::Orgs.org_guid_to_name(object.org_id)
+        scope =
+          if object.respond_to?(:org_id)
+            ChefFixie::Sql::Orgs.org_guid_to_name(object.org_id)
           else
             :global
           end
@@ -57,12 +57,12 @@ module ChefFixie
     end
 
     class ReverseMapper
-      attr_reader :names,:by_type, :instance
-                     
+      attr_reader :names, :by_type, :instance
+
       def initialize
         # name of object map
         @names ||= {}
-        @by_type ||= {:actor=>{}, :container=>{}, :group=>{}, :object=>{}}
+        @by_type ||= { :actor => {}, :container => {}, :group => {}, :object => {} }
         # maps class to a pre-created instance for efficiency
         @instance ||= {}
       end
@@ -75,14 +75,14 @@ module ChefFixie
         names[name] = klass
         by_type[type][name] = klass
       end
-      
+
       def dump
         pp names
       end
 
-      def authz_to_name(authz_id, ctype=nil)
+      def authz_to_name(authz_id, ctype = nil)
         types = if ctype.nil?
-                  AuthzUtils::Types
+                  AuthzUtils::TYPES
                 else
                   [ctype]
                 end
@@ -92,52 +92,50 @@ module ChefFixie
             return result if result != :unknown
           end
         end
-        return :unknown
+        :unknown
       end
     end
 
     def self.mapper
       @mapper ||= ReverseMapper.new
     end
-    
+
     def self.register(klass, name, type)
-      self.mapper.register(klass,name,type)
+      mapper.register(klass, name, type)
     end
 
     # Translates the json from authz for group membership and acls into a human readable form
     # This makes some assumptions about the shape of the data structure, but works well enough to
     # be quite useful
     def self.struct_to_name(s)
-      mapper = AuthzMapper::mapper      
+      mapper = AuthzMapper.mapper
       if s.kind_of?(Hash)
         s.keys.inject({}) do |h, k|
           v = s[k]
           if v.kind_of?(Array)
             case k
-            when 'actors'
-              h[k] = v.map {|a| mapper.authz_to_name(a,:actor) } #.sort We should sort these, but the way we're returning unknown causes sort 
-            when 'groups'
-              h[k] = v.map {|a| mapper.authz_to_name(a,:group) } #.sort to fail
+            when "actors"
+              h[k] = v.map { |a| mapper.authz_to_name(a, :actor) } #.sort We should sort these, but the way we're returning unknown causes sort
+            when "groups"
+              h[k] = v.map { |a| mapper.authz_to_name(a, :group) } #.sort to fail
             else
               h[k] = v
             end
           else
-            h[k] = self.struct_to_name(v)
+            h[k] = struct_to_name(v)
           end
           h
         end
       end
     end
-    
+
     module ClassMethods
       # TODO: We should be able to automatically figure out the type somehow.
       # At minimum should figure out a self check
       def register_authz(name, type)
-        AuthzMapper::register(self,name,type)
+        AuthzMapper.register(self, name, type)
       end
     end
-    
+
   end
 end
-
-  

data/lib/chef_fixie/authz_objects.rb

@@ -17,16 +17,16 @@
 # Author: Mark Anderson <mark@chef.io>
 #
 
-require 'pp'
-require 'ffi_yajl'
-require 'chef/http'
+require "pp"
+require "ffi_yajl"
+require "chef/http"
 
-require 'chef_fixie/config'
+require_relative "config"
 
 module ChefFixie
 
   class AuthzApi
-    def initialize(user=nil)
+    def initialize(user = nil)
       @requestor_authz = user ? user : ChefFixie.configure { |x| x.superuser_id }
       @auth_uri ||= ChefFixie.configure { |x| x.authz_uri }
       @rest = Chef::HTTP.new(@auth_uri)
@@ -42,38 +42,41 @@ module ChefFixie
 
     def get(resource)
       result = @rest.get(resource,
-                         'Content-Type'=>'application/json',
-                         'Accept'=>'application/json',
-                         'X-Ops-Requesting-Actor-Id'=>@requestor_authz)
+                         "Content-Type" => "application/json",
+                         "Accept" => "application/json",
+                         "X-Ops-Requesting-Actor-Id" => @requestor_authz)
       FFI_Yajl::Parser.parse(result)
     end
+
     def put(resource, data)
-      result = @rest.put(resource, self.json_helper(data),
-                         'Content-Type'=>'application/json',
-                         'Accept'=>'application/json',
-                         'X-Ops-Requesting-Actor-Id'=>@requestor_authz)
+      result = @rest.put(resource, json_helper(data),
+                         "Content-Type" => "application/json",
+                         "Accept" => "application/json",
+                         "X-Ops-Requesting-Actor-Id" => @requestor_authz)
       FFI_Yajl::Parser.parse(result)
     end
+
     def post(resource, data)
-      result = @rest.post(resource, self.json_helper(data),
-                          'Content-Type'=>'application/json',
-                          'Accept'=>'application/json',
-                          'X-Ops-Requesting-Actor-Id'=>@requestor_authz)
+      result = @rest.post(resource, json_helper(data),
+                          "Content-Type" => "application/json",
+                          "Accept" => "application/json",
+                          "X-Ops-Requesting-Actor-Id" => @requestor_authz)
       FFI_Yajl::Parser.parse(result)
     end
+
     def delete(resource)
       result = @rest.delete(resource,
-                            'Content-Type'=>'application/json',
-                            'Accept'=>'application/json',
-                            'X-Ops-Requesting-Actor-Id'=>@requestor_authz)
+                            "Content-Type" => "application/json",
+                            "Accept" => "application/json",
+                            "X-Ops-Requesting-Actor-Id" => @requestor_authz)
       FFI_Yajl::Parser.parse(result)
     end
 
   end
 
   module AuthzUtils
-    Types = [:object,:actor,:group,:container] # order is an attempt to optimize by most probable.
-    Actions = [:create, :read, :update, :delete, :grant]
+    TYPES = [:object, :actor, :group, :container] # order is an attempt to optimize by most probable.
+    ACTIONS = [:create, :read, :update, :delete, :grant]
 
     def to_resource(t)
       # This is a rails thing... t.to_s.pluralize
@@ -81,20 +84,20 @@ module ChefFixie
     end
 
     def get_type(id)
-      Types.each do |t|
+      TYPES.each do |t|
         begin
-          r = AuthzApi.get("#{self.to_resource(t)}/#{id}")
+          r = AuthzApi.get("#{to_resource(t)}/#{id}")
           return t
-        rescue RestClient::ResourceNotFound=>e
+        rescue RestClient::ResourceNotFound => e
           # expected if not found
         end
       end
-      return :none
+      :none
     end
 
     def check_action(action)
       # TODO Improve; stack trace isn't the best way to communicate with the user
-      raise "#{action} not one of #{Actions.join(', ')} " if !Actions.member?(action)
+      raise "#{action} not one of #{ACTIONS.join(', ')} " if !ACTIONS.member?(action)
     end
 
     def check_actor_or_group(a_or_g)
@@ -102,7 +105,7 @@ module ChefFixie
     end
 
     def resourcify_actor_or_group(a_or_g)
-      return a_or_g if ["actors", "groups"].member?(a_or_g)
+      return a_or_g if %w{actors groups}.member?(a_or_g)
       check_actor_or_group(a_or_g)
       to_resource(a_or_g)
     end
@@ -131,10 +134,9 @@ module ChefFixie
     end
 
     def authz_api
-       @@authz_apiAsSuperUser ||= AuthzApi.new
+      @@authz_api_as_superuser ||= AuthzApi.new
     end
 
-
     # we expect to be mixed in with a class that has the authz_id method
     def prefix
       "#{to_resource(type)}/#{authz_id}"
@@ -145,9 +147,14 @@ module ChefFixie
       [:unparsed, result] # todo figure this out in more detail
     end
 
+    def authz_delete
+      authz_api.delete(prefix)
+    end
+
     def acl_raw
       authz_api.get("#{prefix}/acl")
     end
+
     # Todo: filter this by scope and type
     def acl
       ChefFixie::AuthzMapper.struct_to_name(acl_raw)
@@ -161,11 +168,11 @@ module ChefFixie
       [resource, ace]
     end
 
-
     def ace_raw(action)
-      resource,ace = ace_get_util(action)
+      resource, ace = ace_get_util(action)
       ace
     end
+
     # Todo: filter this by scope and type
     def ace(action)
       ChefFixie::AuthzMapper.struct_to_name(ace_raw(action))
@@ -173,14 +180,11 @@ module ChefFixie
 
     def expand_actions(action)
       if action == :all
-        action = AuthzUtils::Actions
+        action = AuthzUtils::ACTIONS
       end
       action.is_a?(Array) ? action : [action]
-    end
-
-
+    end # add actor or group to acl
 
-    # add actor or group to acl
     def ace_add_raw(action, actor_or_group, entity)
       # groups or actors
       a_or_g_resource = resourcify_actor_or_group(actor_or_group)
@@ -190,9 +194,10 @@ module ChefFixie
       ace[a_or_g_resource].uniq!
       authz_api.put("#{resource}", ace)
     end
+
     def ace_add(action, entity)
       actions = expand_actions(action)
-      actions.each {|a| ace_add_raw(a, entity.type, entity) }
+      actions.each { |a| ace_add_raw(a, entity.type, entity) }
     end
 
     def ace_delete_raw(action, actor_or_group, entity)
@@ -207,7 +212,7 @@ module ChefFixie
 
     def ace_delete(action, entity)
       actions = expand_actions(action)
-      actions.each {|a| ace_delete_raw(a, entity.type, entity) }
+      actions.each { |a| ace_delete_raw(a, entity.type, entity) }
     end
 
     def ace_member?(action, entity)
@@ -216,7 +221,6 @@ module ChefFixie
       ace[a_or_g_resource].member?(entity.authz_id)
     end
 
-
     def acl_add_from_object(object)
       src = object.acl_raw
 
@@ -254,15 +258,21 @@ module ChefFixie
     def group_raw
       authz_api.get("#{prefix}")
     end
+
     # Todo: filter this by scope and type
     def group
       ChefFixie::AuthzMapper.struct_to_name(group_raw)
     end
 
+    def list
+      group
+    end
+
     def group_add_raw(actor_or_group, entity)
       entity_resource = to_resource(actor_or_group)
-      authz_api.put("#{prefix}/#{entity_resource}/#{entity.authz_id}",{})
+      authz_api.put("#{prefix}/#{entity_resource}/#{entity.authz_id}", {})
     end
+
     def group_add(entity)
       group_add_raw(entity.type, entity)
     end
@@ -278,7 +288,7 @@ module ChefFixie
 
     def member?(entity)
       members = group_raw
-      return members[resourcify_actor_or_group(entity.type)].member?(entity.authz_id)
+      members[resourcify_actor_or_group(entity.type)].member?(entity.authz_id)
     end
   end